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Visual Development Environment For i 


WATCOM VX'Rexx is an easy to use visual development 
environment for creating applications that leverage the 
capabilities of OS/2 2.x and exploit the Presentation Manager 
graphical user interface. VX*Rexx combines a project 
management facility, visual designer and an interactive source- 
level debugger to deliver a very approachable and highly 
productive visual development environment. 


Design Applications 

Visually Create rich graphical 
applications quickly and easily using 
the visual design environment. With 
the visual designer, you can 
graphically create Presentation 
Manager interface objects, quickly 
customize their properties, and 
easily attach Rexx procedures to 
the objects. 


Integrated Development 
Environment Build, test and 

debug your application without 
leaving the development 
environment. Then package your 
application as an EXE file or PM 
macro for royalty-free redistribution. 
The power of the integrated 
development environment and 
debugger can also be used with your 
existing Rexx applications. 


Powerful Open 
Environment Enjoy the 

simplicity of event-driven 
programming together with the 
global editing capabilities 
essential for professional project 
management. WATCOM 
VX»Rf.xx is open and extensible 
through IBM’s object oriented 
System Object Model (SOM) 
technology. You can access all 
standard Rexx API’s including 
DB Manager, because VX'Rexx 
is based on the OS/2 2.x standard 
system Rexx. 


I 


Highlights 


► Easy to use visual development environment 

► Create and modify objects dynamically at 
both edit and run time 

► Powerful project management facility 

► Advanced interactive source-level debugger 

► Package your applications as EXE files or 
PM macros 

► Access to standard Rexx API’s including 
DB Manager 

► System Object Model (SOM) based object 
manager 


Support for multi-threaded applications 
Include OS/2 style help and hints in your 
applications 

Supports SAA CUA'91 objects 
Autosizing and alignment of objects 
Integrated console window support for 
existing Rexx programs 
Royalty-free run-time available 
Multiple modeless window support 
Create PM macros for applications 
supporting Rexx as a macro language 













Suggested Retail: $299* 

Introductory Offer $99* 

(until September 30,1993): includes royalty-free runtime 

Call Toll Free 

1 - 800 - 265-4555 


t facil' tieS a Sions 


nick a nd easy 


WAT 


The integrated visual 
solution builder for OS/2 2.x. 


WATCOM International 

415 Phillip Street, Waterloo, Ontario, Canada, N2L 3X2 
Phone: (519) 886-3700 Fax: (519) 747-4971 


OS/2 Rexx 


Interactive Debugging 

If an error occurs at run-time, 
VX*Rexx will display a traceback 
pinpointing the source line where 
the error occurred. A simple click 
of the mouse will return you to the 
source edit window to correct the 
error. The built-in interactive 
source-level debugger lets you set 
breakpoints, step through code 
and watch variables to track down 
complex problems. 


WATCOM VX-Rexx: 


Build Professional 
Applications 

WATCOM VX*Rexx allows 
you to leverage key OS/2 features 
to create professional applications. 
Build applications that dynamically 
create and modify CUA’91 screen 
objects at both edit and run-time, 
and include OS/2 style help and hints. 


Create Multi-Threaded 

Applications Every VX*Rexx 

application contains multiple threads. 

One thread remains responsive to user 
input while others continue processing. 

In addition, VX'Rexx provides the 
ability for advanced applications to easily 
use additional threads. 
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"Prices and specification ate subject to change without notice. Price does not include freight and taxes where applicable. Prices 
quoted in US dollars. WATCOM, the Lightning Device, and VX'Rexx are trademarks of WATCOM Intematronal Corporation. Other 
trademarks are the properties of their respective owners, ©Copyright 1993 WATCOM International Corporation. 















You’re closer to Client/Server 

than you think. 
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There are plenty 
of choices of GUI 
builders, plenty of 
choices of databases, 
there are even choices 
of cross-platform 
communications, but 
Micro Focus is 
uniquely qualified to 
provide complete 
client/server solutions 
for your industrial-strength applications today. 

The Micro Focus Client/Server Solutions 
encompass an open framework allowing you 
to choose Micro Focus’ best tools for tasks 
such as building graphical 
user interfaces or handling 
program to program 

communications. 
Or, instead, plug 
in the tool of your 
choice. 
Whether you 
are building 
applications with distributed data, distributed 
application code or distributed presentation 




♦♦ 


Micro Focus Client/Server 
Solutions provide middle¬ 
ware components so developers need only know how to 
plug into the appropriate platform. 


services, the Micro Focus Client/Server 
Solution is right for you. No matter what mix 
of thin or thick clients, or thin or thick servers, 
you will find it all in one place. And, best of all, 
the Micro Focus Client/Server c v xtNT/s **^ 
products provide a bridge from 
the old to the new, leveraging 
existing resources with the 
latest technology. 

For a brochure on the _ 

Micro Focus Client/Server Solution, call 
800-872-6265. Discover how Micro Focus 
delivers “A Better Way of Programming7” 

MICRO FOCUS 

Micro Focus. Inc . 2465 East Bayshorc Road. Palo Alto. CA 94303 Tel. (415) 856 4161. 



Micro Focus is a registered trademark and *A Better Way of Programming" ts a trademark of Micro Foots. Inc All other trademarks are property of their respective companies 

GSA Contract Number GS0OK9OAGS5251-PS02 
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The best-looking BASIC 
you've ever seen. 



CA-Textor CACompete! 

This is what OS/2 is all about. 

Making your PCs do more than 
ever before. 

Which is why Computer 
Associates, the world’s leading 

Software Company, iS pleased Professional word process- Spreadsheet ease, plusmul- 

to introduce six 


ing anyone can use. 


tidimensional modeling. 


CASuperProject Simply Accounting 


souped-up applica¬ 
tions for OS/2 users. 

All are proven win¬ 
ners that fully utilize 
0S/2’s unique 
strengths. From the 
Workplace Shell to 
true multitasking to 
multimedia. 

Businesses large and small will see benefits 
right out of the box with CA’s easy-to-learn, 
easy-to-use programs. Everything from word 


CA-dBFast 



The most efficient way 
to get the job done. 


Small business accounting 
has never been simpler. 


processing and project man¬ 
agement to accounting, 
spreadsheets and program¬ 
ming becomes faster - and 
more affordable. 

Plus, you’ll get the ulti¬ 
mate in flexibility 
with this unprece¬ 
dented offer: Buy 
the OS/2 version 
of any of these 
applications, and 
we’ll include the 
Windows version 
absolutely free. 

For More Information, 

Call 1-800 CALL CA1 Ext. 260. 
Congratulations on choosing OS/2. Now 
add the right apps — and watch it really take off. 


Adding a GUI to dBASE 
apps is a snap. 


(Computer 

/Associates 

Software superior by design. 

© Computer Associates International. Inc., One Computer Associates Plaza, Islandia, NY 11788-7000. All product names referenced herein are trademarks of their respective companies. 
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BY DICK CONKLIN 


Editors 

Comments 


What's New, OS/2 ? 


ow that OS/2 21 is available, we can be 
more specific about the new release. In 
this issue, our writers give us an overview 
of version 2,1's new features, plus a closer look at its 
CD-ROM and printing support, 

SPOTLIGHT ON TAUGENT 

What's going on at Taligent, anyway? Many of 
you have asked that question, so we paid a visit to 
Mr, Taligent himself, Joe Guglielmi. Joe shares his 
view of Taligent's world of objects and what it 
means to OS/2 developers. 

SPEECH RECOGNITION 

Everyone agrees that speech recognition will play 
a big role in the future of computing. Maybe we're 
not quite ready for 200Vs HAL but some applica¬ 
tions have put this cutting-edge technology to 
work today. In our first article on this fascinating 
topic, we'll look at a new OS/2 speech recognition 
development tool 

PRODUCT WATCH 

We're adding a new department in this issue, called 
Product Watch/Calendar. It will tell you about the 
latest OS/2 tools and applications, upcoming shows 
and conferences, and new support programs for 
developers. Send us your press releases! 

NEWS YOU CAN USE 

Look for the latest OS/2 publication—the electron¬ 
ic IBM Personal Software Products Developer Support 
News. It's on CompuServe and several other popu¬ 


lar bulletin board systems. In it, youTl find up-to- 
date news of IBM's technical, 
business, and marketing pro¬ 
grams for developers. For more 
information, drop an Internet 
note to dsnews@vnet.ibiTLcom. 

MORE OS/2 MORE OFTEN 

Does our cover say "July/ 

August"? That's no misprint— 

OS/2 Developer just went bi¬ 
monthly. Now we'll be coming to you six times a 
year instead of four; that means some challenges 
for our staff hut a bonus for our readers. We'll 
have more news in the months ahead. Watch this 
space,.. 



Dick Conklin 
Editor 


NOTICE 

The IBM Communications Manager Client 
Server/ 2 product, described in our Spring 1993 
issue ("Extending Application Interfaces For 
Communications: Client/Server/' page 27) was 
withdrawn after our press date. OS/2 Developer 
regrets any inconvenience this may have 
caused. 




Dick Conklin 


IBM OS/2 Developer: Vol. 5, No. 3, July/August 1993 
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Taligent, a joint project of IBM and Apple, is redefining the computer industry and our way of looking at the cre¬ 
ation of system software, bob orfali and dan harkey explore. 


Taligent: A New Paradigm, 
A New Approach 



Bob Orfali 



Dan Harkey 


o OS/2 developers, Taligent can seem like a 
"Land of Oz" of operating systems, located 
"somewhere over the rainbow." Why 
worry about Taligent when our brain cells are 
overloaded just trying to digest new OS/2 features 
like DSOM, the microkernel, DCE, LAN NetView, 
and motion-video multimedia? Why should OS/2 
developers like us need to know about Taligent? 
At least that was our attitude when we began this 
article—but it soon became evident that there was 
a lot about Taligent that OS/2 developers need to 
know about. 

A New Paradigm? 

The first thing we discovered about Taligent is that 
its technology is multifaceted, elusive, and would 


not fit neatly into our current model of "the way 
things are." For this article, we were not provided 
with specifications, product sheets, demos, or an 
architecture reference model. And this operating 
system is not like any other; it's all new and differ¬ 
ent. When we expressed our bewilderment to 
Mike Potel, Taligent's vice president of technolo¬ 
gy, he joked, "Joe Guglielmi had the same problem 
when he became CEO at Taligent. Every time he 
talked to somebody, he got a different view of this 
beast." 

This article starts by looking at Taligent from an 
OS/2 perspective and provides a framework for the 
terminology of the interview. We then turn the 
microphone over to Joe Guglielmi. We could never 
match Joe's eloquence and passion for his product. 
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OS/2 and Workplace OS 

When does Taligent enter the picture? In Figure 1, 
we offer a "fearless forecast" of how the desktop 
operating systems from IBM and Taligent come 
into the picture over the next few years. In all 
cases, the future lies in operating systems that 
embrace object-oriented technology. OS/2 2.x is 
optimized for Intel processors and will continue 
to evolve throughout the '90s, The Workplace OS 
is a portable environment that is designed to run 
on top of Intel and RISC hardware from a variety 
of vendors, with the portability layer provided by 
a common microkernel. The 32-bit OS/2 applica¬ 
tions you create should run on all platforms. 

In our scenario, objects become very important. 
Distributed object services based on the System 
Object Model (SOM) become a vehicle to share 
objects across operating systems such as OS/2, 
DOS, Windows, UNIX, AS/400, and MVS. In 
addition, object-oriented application frameworks 
containing both IBM and Taligent technology will 
be offered for OS/2 2.x, UNIX, and Workplace OS. 

In Figures 2 and 3, OS/2 2.x and the Workplace 
OS support D50M, object services, and the object- 
oriented application frameworks. OS/2 2.x contin¬ 
ues to evolve, providing optimal performance on 
the large installed base of Intel machines. 

A Guide to Microkernels, 

Personalities, and Frameworks 

Figure 3 helps explain all the new terminology and 
shows where Taligent fits in. Several pieces of the 
Workplace OS play together: the IBM Microker¬ 
nel, the operating system personalities, the distrib¬ 
uted object layer, the object-oriented frameworks 
containing Taligent technology, and the Work¬ 
place user interface. We will briefly introduce 
these pieces, then move on to Taligent. 

The IBM Microkernel utilizes technology from Mach 
3.0 research. Mach 3.0 is a portable microkernel 
developed by Carnegie Mellon University. The IBM 
microkernel and Mach 3.0 remove the UNIX-specific 
elements and provide a few well-defined services— 
including interprocess communications, virtual 
memory, ports, task dispatching, and threads—used 
to build all system services. The rest of the operating 
system functions—file I/O, user interface services, 
device drivers, and communications—are imple¬ 
mented outside the microkernel. As a result, the 


microkernel can be smaller, faster, and more scalable 
while providing a higher level of robustness, securi¬ 
ty, and integrity. Elements outside the microkernel, 
such as the device drivers and file systems, can be 
shared by the operating systems that run on top of it. 
rBM's multithreaded microkernel supports symmet¬ 
ric multiprocessing, a technique that allows pro¬ 
grams to run concurrently on multiple processors in 
tightly-coupled configurations. It is intended to sup¬ 
port Intel and a variety of RISC processors. 



Taligent At A Glance 

Founded in March 1992, Taligent is an independent system software 
company owned jointly by Apple Computer Inc. and IBM Corp. and 
headquartered in Cupertino, Calif. The company has 310 employees, 
who use object-oriented technology tD develop system software from 
the bottom up. The emphasis of the company's charter is on enabling 
the innovators and entrepreneurs who spawned the desktop revolution, 
allowing them to take full advantage of object technology's benefits and 
encouraging a new model for innovation centered around objects. Tali¬ 
gent s system software will be open for extension at all levels by soft¬ 
ware developers, hardware OEMs, and systems vendors. The company 
will license, market, and support its software platform worldwide. 


Personality modules provide operating system-spe¬ 
cific API services. IBM intends to support DOS, 
Windows 3.x, OS/2 2.x, and UNIX personalities, 
with the microkernel concurrently executing mul¬ 
tiple operating system personalities on one 
machine. (One personality, designated as domi- 
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Figure 2 The Workplace Shell OOUl for OS/2 2.x 



nant, controls the appearance of the 
desktop.) The personalities will preserve 
investments in code and application 
packages. The microkernel also provides 
the means to build specialized servers 
and operating system replacements. 

The distributed object layer, based on 
IBM's Distributed System Object Model 
(DSOM) technology, allows objects to 
operate across networks. This layer also 


includes services for storing, replicat¬ 
ing, shadowing, creating, destroying, 
and specifying objects, DSOM is based 
on standards set by the Object Manage¬ 
ment Group (QMG), an industry con¬ 
sortium of over 200 member compa¬ 
nies, For example, DSOM defines 
objects using the Common Object 
Request Broker Architecture (CORBA) 
interface definition language. DSOM 
uses OMG's specification of an Object 


Request Broker (ORB) to find and 
invoke objects on different machines. 
The object services are intended to 
comply with OMG's object life cycle 
and persistence specifications when 
they become available, OMG and IBM 
are also working on specs for shared 
objects and object transactions for 
client/server environments. All this 
means that OS/2 is already deeply 
involved in objects, adhering to current 
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industry standards. These objects are, 
of course, built on top of a standard 
operating system* 

The object-oriented application frame¬ 
works intend to provide a portable dis¬ 
tributed set of object sendees to help 
create user applications, A framework 
makes writing object-oriented applica¬ 
tions from raw class libraries less 
tedious; you begin with complete 
working subsystems, which can be 
customized for individual applications. 
You can also create applications by 
wiring subsystems together with visual 
application assembly fools. Third party 
software companies will be able to pro¬ 
vide parts or entire components that 
can be assembled or modified by users 
or system integrators. 


The user interface for IBM's "Workplace" 
line is {you may have guessed from the 
name) based on OS/2's Workplace 
Shell. This object-oriented user interface 
will be adapted for DOS, UNIX, and 
OS/2, Users think in terms of directly 
manipulating objects on the desktop 
rather than dealing with programs and 
other computer-based metaphors* IBM 
is working on making the user interface 
even easier to use by adding powerful 
new visual metaphors* 


m ow that we've introduced 
m mm some of the terminology, we 
m W give the floor to ]oe Gugliel- 
mi, the chairman and CEO of Taligent* 
We used the system detailed in Figure 3 
as a reference point for our questions. 


Developer; Let's start with one of the loftier 
questions. Taligent was jointly founded by 
and Apple. What were your original 
goals , and how have they changed? 


Joe: When Apple and IBM got together 
on this project it was because both com¬ 
panies had a common vision of the 
importance that object-oriented technol¬ 
ogy would have in the marketplace. 
Both had substantial interest and invest¬ 
ments already in that technology. We 
first looked at a joint development 
using the Power PC RISC chip and then 


it grew into a more encompassing pro¬ 
ject that would commercialize objects on 
high-volume platforms and get the 
industry to make the transition from a 
procedural world to an object world. 


fully integrated into an operating form. 
So as a kind of a Lucky Strike Extra, 
you get to do those in an integrated 
fashion* By the way, in an object sys¬ 
tem all those things become simply 




Joe M. Guglielmi 

Joe Guglielmi, 51, is chairman and CEO of Taligent Inc. He moved to Taligent 
from IBM, where he was general manager of marketing and business develop¬ 
ment for the Personal Systems Line of Business. In his 30-year career at IBM, 
Guglielmi designed the business strategy for IBM's first successful minicomput¬ 
er line, helped establish a division for marketing IBM’s first PC products, and 
established IBM's first alliances with PC application companies. 



Why is that so important? 

Because our goal is to provide a dra¬ 
matic improvement in the application 
development environment. I talk about 
it in terms of moving the cycle from 
years to months and providing a brand 
new environment, in terms of function¬ 
ality, that will encourage innovation. It 
also turns out that, since we're writing 
an operating system from scratch, we 
get to do some things right. We now 
have a rich heritage in multimedia, 
advanced graphics support, and other 
capabilities that we know should be 


objects that you can deal with. You 
don't worry about whether you're 
dealing with full-motion video or 
whether you're dealing with static data 
types. Everything is treated as an object 
structure* 

Where do you see this technology going? 

We see enormous potential in this tech¬ 
nology—not because it's object-orient¬ 
ed, but because it can give the industry 
a brand new base that will allow us to 
move from today's environments, 
which are constrained, we think, by the 


JULY/AUGUST 1993 


9 







operating system capabilities. Just as 
OS/2 2,0 unleashed the power of a 
microchip we'd been shipping for years, 
this will begin to unleash the power and 


This is where our strategy has changed 
dramatically. Initially, the notion was 
to deliver one large brand-new operat¬ 
ing system, top to bottom, in one really 


ments, System 7 investments carry for¬ 
ward? How do we ensure that we don't 
force a change in the marketplace all at 
once to a new technology? 


I "What we provide is an environment that lets 
(developers) do a much better implementation of 
what they do best." 


creativity in the industry in a different 
way. We won't be constrained by the 
old paradigms of procedural operating 
systems. 

How will you get this technology into the 
marketplace? 


significant drop. We've become more 
realistic about that; we've had to deal 
with very pragmatic issues* How do 
we, when providing this great step 
function, deal with current invest¬ 
ments? How are we going to make sure 
the OS/2 investments, AIX invest¬ 


So how do you do that? 

We've focused our strategy over the last 
year on three or four things. One is 
moving the project from a research pro¬ 
ject with two or three technology bases 
to a product development environment 
where we now have the focus on deliv¬ 
ering products that respond to cus¬ 
tomers' requirements to the market¬ 
place. Second, we've spent a lot of time 
staging the project.*, we can't do it all at 
once. We'll never be able, in one release, 
to compare to those established operat¬ 
ing systems, so that's a bad goal. So let's 
focus on areas in which we think the 
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Navigate the maze 

Promises are cheap, GUI develop! 
that Gpf 2.1 DELIVERS, 

With this powerful point and click visual programming environment you can create a CUA ’91 Graphical User Interface for OS/2 
Presentation Manager* or MS DOS/WindowS® in as little as 10% of the time required to hand code the same design 

What You See Is What You Get programming reduces weeks of coding to hours. Quickly prototype and test your interface, then let 
Gpf write the code. Gpf generates error free, structured Object Oriented C or C++ source, complete with embedded SQL for OS/2 
DataBase. Custom Help and Logic are added to controls as they are drawn to create full Client/Server or Stand-alone applications! 

Gpf is hosted on OS/2 2.x and generates native code for OS/2 2.x, OS/2 1.3.x and MS Windows 3.0 or 3.1 Of course this means 
maximum performance with no run time module and no royalties! 


Seeing Gpf is believing! 

* Design 32 or 16 bit GUIs for IBM OS/2® or Microsoft Windows® 

• Be creative, WYSIWYG design environment • Full CUA ’91 Control set, 32 or 16 bit 

• Full application and/or DLL generation • Reusable Objects 

* Minimal time to application delivery • Automatic documentation 


G 

P 

f 

SYSTEMS, INC 


Try us, FREE Demo Software Available . 

Order Gpf Pro TooIKit today for just $1440°° 

Separately: Gpf 2.1 for $1295" & GpfTools for $195" 

Or, try: Gpf 2.0 Single Platform, now available for just $495 00 

Gall Gpf Systems Inc. at: (800) 831-0017 



* GUI Programming Facility 


fax (203) 873-3302 30 Falls Road, Moodus, CT 06469 
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technology substantially leverages itself. 
We're going to stage our technology to 
focus on both corporate and software 
developers. What do they need first to 
provide value? Taligent's proposition is 
that the value comes from the develop¬ 
ers* We don't compete with them for 
word processors or spreadsheets, and 
we don't do databases* What we pro- 


operating systems like OS/2, AIX, and 
System 7. That's a pretty profound 
change. That's something that's not 
very natural for a team developing a 
new operating system to do. A devel¬ 
opment team wants to make the 
biggest step function change, one that 
differentiates between current and 
future environments. Well, we con- 


I "We benefit if IBM and Apple evangelize object 
technologies and provide us with a more 
evolutionary path. We're a small company; 
we can't do it all ourselves." 


vide is an environment that lets them do 
a much better implementation of what 
they do best. Our delivery channels— 
Apple, IBM, and others—are also going 
to add value to this. 

Yes, but every new operating system needs 
to do that kind of stuff... 

It does* But the second new notion is 
that we would take pieces of this tech¬ 
nology and make it available to current 


eluded that without some strategy to 
get the technology into the market 
early, the step function was too great. 
This isn't 1983 anymore. This isn't 
about "I have a great technology; well 
just get people to stop what they're 
using and move over to it/' We have 
example after example in the market¬ 
place today where great technology 
can't get commercial acceptance* So the 
notion was, why don't we take pieces 
of this technology and make them 


available to current operating systems? 

What does that do for those operating 
systems? 

First of all, if we've done classy imple¬ 
mentations of the technology, it will 
enhance them. OS/2 will be more com¬ 
petitive; System 7 will be more competi¬ 
tive* By the way, we're not limiting it to 
just those two; our strategy is to go after 
as many of the current operating sys¬ 
tems as possible* Think about all the 
UNIX environments or—ultimately— 
any 32-bit system that can carry the 
technology* 

What are the benefits to Taligent of mak¬ 
ing this technology available to others? 

The technology will make OS/2 and 
System 7 more competitive and they, in 
turn, will provide us a transition plat¬ 
form for the wide-scale introduction of 
objects to the marketplace. We benefit if 
IBM and Apple evangelize object tech¬ 
nologies and provide us with a more 
evolutionary path. We're a small com¬ 
pany; we can't do it all ourselves. But 
by putting pieces out in the market¬ 
place, we begin to provide a transition 
mechanism—that is, investments made 
in applications that use that technolo- 
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gy under a mature operating system 
can be carried forward into Taligent 
when the time is right. So when Tali¬ 
gent comes, customers can decide 
whether they want to move to it or not. 
This is not a forced march. It doesn't 
mean one Monday morning OS/2 goes 
out of business or System 7 goes out of 
business—that's not the strategy. 

But if you've made your object technology 
available on other platforms , why would 
anybody ever want to move to Taligent? 

Taligent will be fully object-oriented 
with a very consistent object model. 
When you enter Taligent, everything in 
the system is an object, with no differ¬ 
entiation between a system object and 
an application object. We can imple¬ 
ment a very consistent object structure: 
once you're in the object space, you can 
leverage every element in that environ¬ 
ment, You won't ever have to deal with 
the procedural elements of a system. 
Take NextStep, for example. Steve 
0obs) has a great user interface tool, 
but you still have to bounce into UNIX 
from within your applications. 

What are the advantages of having objects 
at the operating system level? 

Envision a growing industry that 
would provide system frameworks, 
networking frameworks. Take commu¬ 
nications,., If they don't like ours, IBM 
or Novell could replace it with their 
own implementation. Device adapters 
can inherit characteristics of a particu¬ 
lar device class and customize them to 
fit their particular needs. It's a very 
consistent way of taking advantage of 
new hardware. System software can 
then keep up with fast-moving hard¬ 
ware technology. 

OK, so what's in it for application software 
developers? 

If we do our job right, in the mid-90s 
application developers will not be writ¬ 
ing code but will instead be shopping 
for objects. If you think about it, there 
will be thousands of objects; how do I 


know which one I want to subclass or 
reuse? We're building a very consistent 
development environment with view¬ 
ers or browsers that Let you try out 
these objects and understand what they 
can do for you. You'll have a full 
environment that lets you think of 
your world in terms of objects. 


Will some of that environment be made 
available on OS/2? 

Yes. I didn't mean to imply that the 
layers of components we provide for 
OS/2 won't be great; they'll move 
objects forward and condition the mass 
market for objects. Taligent has the 



MOST COMPUTERS ONLY 
RESPOND TO TOUCH. 
WE'RE HELPING THEM DEVELOP 
A SENSE OF HEARING. 



Speech recognition is here! 


Introducing I CSS, the IBM Continuous 
Speech Series. A developer's tool thot has 
the flexibility to speech enable your 
programs. This software product provides 
total speaker independence—there's no 
special voice training required. If some¬ 
one can talk, they con use your speech 
enabled program. And ICSS also features 
"continuous speech"—allowing you to 


speak completely naturally, the way you 
would to a friend. With a 1,000 word 
active grammar that is dynamically 
switchable, the possibilities are limitless. 
ICSS runs on 486DX machines running 
OS/2 2.x, as well os RISC/6000 
machines running AIX 3.2. For more 
information, call 1*800-627-8363. 

ICSS from IBM. ^ 

We hear you. = ~ = 

















added luxury of being able to put the 
whole thing together from the bottom 
to the top. 


Speaking of the bottom , both Taligent and 
OS/2 will be running on the same Mach 3 
microkernel—is that correct? 

We're on the same microkernel, but 
IBM is not shipping Mach. They're 
shipping a microkernel based on Mach 
technology. Mach is a big, heavyweight 
thing; IBM and Taligent are creating a 
much more lightweight version of 


try. I'm trying to answer the guy who 
says, "What are you, nuts? Mach can't 
run an object system the way it's cur¬ 
rently designed." The answer is "It 
can't, but the kernel we're implement¬ 
ing can." It's really this notion that the 
core technology is optimized object 
technology and this new common 
microkernel works across OS/2, UNIX, 
and ultimately, hopefully, the industry. 
That's where the world's going. 

So is this microkernel one of the first pieces 
to be delivered? 


mixing objects from a variety of ven¬ 
dors. The fact that the object's interface 
is the standard defined by the Object 
Management Group—the CORBA spec¬ 
ification—is also very attractive. 

Will you support DSOM then , since it's 
based on CORBA? 

Of course. DSOM is a very easy case. 
Its ORB, which is CORBA compliant, is 
one way we deal with objects across 
networks. We know there are objects 
on this network that are going to be 
moved around. 


I " In Taligent, we are dealing with a system opti¬ 
mized for a very large number of small objects.... 
We don't move a few big objects. We move a lot 
of very little things around, so we have a tremen¬ 
dous amount of tasking going on." 


Mach and creating personality-neutral 
servers and services. Taligent is adding 
the mechanisms to make it a first-class 
object environment. We're working on 
the performance implications of mov¬ 
ing thousands of objects around in a 
system. IBM will build the microkernel 
that we'll use as part of our common 
strategy. 

Mach is an open microkernel, something 
perceived as a benefit. Aren't you losing 
that by going to your own microkernel? 

I'm not commenting on the open 
aspect. I'm commenting on Mach's 
poor performance for doing objects. We 
have over four years of experience 
writing microkernels for objects, and 
we know how to do one. Object people 
don't think you can do objects on the 
current version of Mach—it may be OK 
for doing UNIX-type things. The com¬ 
mon IBM microkernel solves those 
technical problems. On the openness 
question, it's up to IBM how they sup¬ 
ply the microkernel back to the indus¬ 


It's actually being developed at IBM. 
Our operating system development 
team is working with the IBM team. 

Are your object frameworks built on SOM 
and CORBA technologies? 

I think we've come to appreciate what 
SOM is and what it isn't. I think there's 
a greater feeling that SOM's design 
point and the problem set that it solves 
are important, very important. Whether 
or not we can, as a team, adopt all of the 
goals of SOM in our design point is the 
discussion we're having with IBM now. 
The reason is, I think, pretty neat to 
think about. In Taligent, we are dealing 
with a system optimized for a very large 
number of small objects. That's how we 
get performance. We don't move a few 
big objects. We move a lot of very little 
things around, so we have a tremen¬ 
dous amount of tasking going on. We've 
got the machine burning and we've 
optimized for performance. We got a lot 
of value out of that optimization. SOM 
is best when the primary objective is 


So you're depending on DSOM to bring 
CORBA. Is IBM representing Taligent's 
position in the OMG? 

IBM, like Sun or HP, has put some time 
into defining the CORBA compliance 
specs. In our implementation, we sup¬ 
port that spec as one of the important 
distributed object models in the indus¬ 
try. Now take Microsoft: they're doing 
CAIRO. I don't know if CAIRO is 
CORBA compliant; the likelihood is 
not. What's going to be our position on 
Microsoft's model? If it's a high-vol¬ 
ume model in the future, we're going 
to have to find a way to support it as 
much as possible. That doesn't mean 
we like it... or don't like it. Our position 
is pragmatic. We have to exist with 
whatever becomes a high-volume plat¬ 
form in the future. We're working with 
IBM, Apple, and others to try to make 
the transition as seamless as we can, 
but we're coming from two different 
worlds. What we won't do is subopti¬ 
mize our world. If we end up lowering 
our goal of full utilization of object 
technology, we will lose the great dif¬ 
ferentiation that comes from it. 

Which IBM groups do you work with on 
object technology? 

I deal through the PSP division, which 
means that Larry Loucks, Cliff Reeves, 
and Lee Reiswig are my contacts in the 
IBM world. So when I deal with Larry 
and Cliff, we either agree or don't 
agree, and I expect them either to bring 
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the rest of the company with them or and beyond* This will give you the high- 
ten me that I've got to go deal with the est affinity with Taligent. Why do 1 say 
situation differently. By the way, that? Because I'm working very hard to 
they're doing a great job evangelizing make that happen. Can I tell developers 
Taligent within IBM, that everything they do in every release 

OS/2—release 2 .7 and beyond. This will give 
you the highest affinity with Taligent.... I'm 
working very hard to make that happen." 



as we can with IBM to make it as pain¬ 
less as we can. We hope it's zero pain* 
That's our goal. But it probably won't be. 

How do you balance that with Apple's 
needs? 

The same way. When we talk to Apple, 
I have the same strategy* The decisions 
we make optimize on where Taligent is 
going, mindful of the fact that helping 
make Apple successful with System 7 
and IBM with OS/2, AIX, and Work¬ 
place OS is good for us, because every 
user in those two or three camps is 
going to be positioned much better to 
come to Taligent. 


If you were speaking directly to, let's say, 
leading edge OS/2 application developers 
who want to do the right thing and position 
their product for the future, what kind of 
strategy or recommendation would you 
map out? 

Here's the strategy I think has to be fol¬ 
lowed. If you're an OS/2 developer, 
keep working with OS/2—release 2.1 


will be cared for seamlessly? No, 1 can't 
tel them that. But they should know that 
we are working very hard with the PSP 
development group to put as much of 
this technology as possible into OS/2 
and AIX, to enhance their competitive¬ 
ness wherever we can, because we 
believe that's good. We believe a big 
OS/2 base is in Taligent's interest and, 
therefore, we're going to work as hard 


Will the Taligent user interface look like 
Mac, Workplace Shell , or something brand 
new? 

That's unclear, frankly, and let me tell 
you why. I believe that the opportuni¬ 
ty to build the Taligent desktop com¬ 
pletely from an object paradigm gives 
us degrees of freedom that can move 
the desktop beyond what is possible 
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today. So we're focused on that; we're 
trying to figure out where we can 
exploit this technology the best Let's 
take one model that could happen. In 
a Taligent world, since everything is 
an object applications don't exist the 
way they exist today. You turn your 
system on and it comes up with a set 
of objects that you deal with, and you 
arrange them in workflows. The 
notion of a workflow world centered 
on the user is much more realistic in a 
full-object world. Everything on the 
screen is a full object linked from the 
top to the bottom of the system. When 
we are ready to deliver a fulLobject 
model to the screen, we're going to go 
back and work with IBM and others 
on where they are today. We'll try to 
make it as evolutionary as we can... 
we'll find ways to see if we can't 
evolve multiple releases of the Work¬ 
place Shell or the Mac look to where 
Taligent is heading. 


What's your planning horizon ? 


We're the only ones in town who are 
worried about 1996.1 don't mean that 
in a negative way. Everybody else is 


cessful by themselves. They will not 
have the kind of critical mass that you 
require. So the design point is to fully 
exploit the technology and then look 
backwards to see how we move the cur¬ 
rent base from here to there, and there 
are several bases. But the thing people 



ought to feel good about is that we're 
thinking about it. It's not like we're over 
here doing our best thing and hope that 
someday it all works. This is the first 
time there is a group that is allowed to 
really focus on where we want to be. At 


" / will tell you this: both Apple and IBM feel 
strongly about keeping their current systems 
viable, and we support that. There's no model 
here, under any circumstance, where all of a 
sudden on Monday morning OS/2 or System 7 
goes away." 


worried about 1993, '94, and '95.1 have 
to stay worried about 1996, or "97: how 
can this technology, when it's fully 
exploited, change the playing field in 
the industry? If we miss the goal of pro¬ 
viding dramatic new technology, the 
industry won't change. If the industry 
doesn't change, none of the interim 
operating systems are going to be sue- 


IBM, you know that there can be terri¬ 
ble constraints on getting there when 
you must suboptimize to support the 
core installed base. But we don't want 
to look like we never talk to each other, 
either, so we have a new r development 
model here. It's different than we've 
ever tried before, and that's why Tali¬ 
gent is a separate company* 


Will Taligent technology bring together the 
System 7 and OS/2 worlds? 

As a separate company, I can talk with 
a lot of authority about what we're 
doing, and 1 can tell you only a little bit 
about how we're working with these 
two companies. If you want their view 
of the world, you've got to go ask IBM 
and Apple. I will tell you this: both 
Apple and IBM feel strongly about 
keeping their current systems viable, 
and we support that. There's no model 
here, under any circumstance, where 
all of a sudden on Monday morning 
OS/2 or System 7 goes away. That isn't 
in the cards, because there's no viable 
scenario where this whole thing can 
make the transition in one day to a new 
environment. So there is going to be, as 
you expect, a continuation of a substan¬ 
tial investment in those current operat¬ 
ing systems, and we're going to find a 
way to make the path to Taligent very 
attractive. 

Are you going to sell a shrink-wrapped Tal¬ 
igent through software stores? 

Yes, but that isn't our model. The 
whole distribution model is changing 
today. The store distribution model is 
going away; I mean, who distributes 
operating systems today? The hard¬ 
ware manufacturers. So our strategy is 
to get the distributors to accept the 
technology, to provide the critical mass, 
the target volumes, so that developers 
can see it. Shrink-wrap and user sales 
will come after that. So the whole 
model is different. It isn't about run¬ 
ning big ads in magazines, hoping that 
users will ask developers to create a 
great application. It's about going to 
developers and saying, "Look, you're 
building a great application. You can 
keep doing it. We're going to give you 
the tools to do it in a third of the time 
and to maintain it more easily by an 
order of magnitude. You know, by the 
way, that when you upgrade it, your 
cycle will go from two years to six 
months. That's worth a lot by itself. Oh, 
there's another opportunity coming. 
Have you thought about spreadsheet 
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Down the road, the shortcomings 
of other client/server development tools are 
certain to become apparent. 



The people in your company who rushed 
out and acquired fancy little GUI builders 
may be buzzing right along with them. 

But what happens when those same people 
need to connect to information outside of 
their department? Or when their user ranks 
1-SOO-OBJ ECTS swell and data flow begins to explode? Or 
when they decide they want to take advantage of the power inher¬ 
ent in the latest release of OS/2? Or when they need to support 
client/server models beyond a simple Database Server architecture? 

It s in situations like these when most application develop¬ 
ment tools show their weakness. And when Easel's robust solu¬ 
tions display their considerable strength, 

ENFI jV"' is the perfect solution for organizations that want 
to use an industrial-strength object-oriented development 

Ot99i, Ewl Corporation. IS Corporate Dr.. Huftirngtort, MA CHBOji. AH Rights Deserved ENF1N. Bntcrprts* Workbench an 


environment to build their client/server applications. 

Enterprise Workbench w delivers cross-platform development 
solutions and unsurpassed connectivity options for building 
new r client/server applications. 

EASEL Renovator +~ allows organizations to extend legacy 
applications into the client/server world, 

Importantly, each of these visual development environments 
offers benefits that go well beyond those of mere GUI builders. 

We have a White Paper that describes the five models of client/ 
server computing and explains how Easel products support every 
one of them. For a free copy, phone us at 1-800-OBJECTS, (Calling from 
outside the U S, and Canada: 617-221-3014,) 

Otherwise, when you w r ant to develop 
enduring, enterprisewide solutions, you 
may find yourself hitting the wall. Corporation 
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engines, word processor engines, 
graphics engines? Have you thought 
about work flow as an application? You 
can really do it now. Have you thought 
about it?" So we're creating a different 
world of applications and when we 
start this model, all of these characteris¬ 
tics will allow hardware manufacturers 
to differentiate their products. 

We want to sell through the high- 


ket share. Between now and 1996, 
there's just not enough time to substan¬ 
tially change the rate flow. I don't 
know what the division between NT, 
DOS, OS/2, and Windows will be; who 
knows? That's completely up to them. 
We haven't seen NT yet, but they'll 
have a large share. I believe OS/2 will 
gain critical mass and have a substan¬ 
tial share. I think Apple will continue 


"We want to sell through the high-volume 
channels. If we don't do that our adoption curve 
is going to be seven years. It takes seven years to 
get an operating system to the market if you're 
good. I want to be a success faster than that" 


volume channels. If we don't do that, 
our adoption curve is going to be seven 
years. It takes seven years to get an 
operating system to the market, if 
you're good. I want to be a success 
faster than that. So all of these strate¬ 
gies are working toward substantially 
reducing the adoption curve for the 
new technology. 

How do you see the operating system pie 
divided in 1996? 

I'd be presumptuous to give you a tar¬ 
get, but I will tell you that existing sys¬ 
tems will continue to have a large mar¬ 


to have a big share. UNIX will probably 
still own eight or nine percent of a 
growing market. By 1995 there'll be 35 
million micros shipped per year, so 
even 10% of that is still a big volume. 

And then Taligent will begin to 
show up. Now I can't tell you exactly 
how big our wedge will be, but it will 
not be zero, because we intend to get 
to market by the mid 90s; hopefully 
earlier. And I think that, as Taligent 
becomes an important environment 
and we demonstrate its utility, that 
wedge will grow more rapidly than 
historical growth rates in new operat¬ 
ing systems. 
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RAIDION LT and OS/2 

A Perfect Match. Introducing RAIDION LT fault-tolerant disk 
arrays for IBM OS/2 or LAN Server based systems. RAIDION LT 
and RAIDWARE " management software combine to create the 
first modular, RAID level 5 fault-tolerant storage subsystem 
designed specifically for use with OS/2. 
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fault-tolerant storage subsystem, and then some. The Hot 
Swap of individual modules is fast and easy. An On-Line Spare 
option enables the subsystem to remain operating in a fault- 
tolerant mode even if one drive in the array fails. RAIDION LT 
is designed to give OS/2 users 100% data availability, 100% of 
the time. 



Easy to Install, Easy to Upgrade. Individual disk modules, 
with either 560 megabytes or 1.0 gigabytes of formatted 
storage, are combined to make a three-module array of either 
1.2 or 2.0 gigabytes. And increasing capacity is simple. Add one 
or more modules to a three-module stack to increase capac¬ 
ity. A total of 4 seven-module^^ stacks can be combined to 
provide up to 28 gigabytes^^^^of fault-tolerant storage. 


For more product information or the name of your nearest authorized 
RAIDION distributor call 1-800-395-3748. 


MICROPOLIS* 

IBM and OS/2 are registered trademarks of IBM Corporation. 
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The release of OS/2 2.1 presents software vendors with a platform for developing 32-bit OS/2 applications and 
tools as well as DOS and Windows applications. Its new and enhanced features let developers exploit emerging 
PC technologies, bymikekaply 

The Release of OS/2 2.1: 

An Overview 

O S/2 2,1 has many major and minor 
enhancements, including better device 
support (CD-ROM, SCSI, video, and print¬ 
er), WIN-OS/2 3*1, a 32-bit graphics engine with 
32-bit seamless drivers, ISO-compliant fonts, 
advanced power management. Personal Comput¬ 
er Memory Card International Association (PCM¬ 
CIA) support, inclusion of Multimedia Presenta¬ 
tion Manager/2, and pen and security "hooks/' In 
addition, improvements have been made to the 
overall performance, specifically to WIN-OS/2 3 + l 
and the Workplace Shell Figure 1 is an overview 
of the OS/2 2,1 system components and the major 
areas in which service fixes and enhancements 
were made, 

OS/22.1 ON CD-ROM 

With the success of CD-ROM Professional Develop¬ 
er's Kit, IBM is shipping OS/2 2.1 on a CD-ROM with 
two accompanying disks to begin installation. The 
upgrade is also available on 3 Vt and 5 VT disks, 

DEVICE SUPPORT 

CD-ROM and SCSI support has been improved in 
OS/2 2,1; OS/2 now provides support for CD- 
ROMs from eight manufacturers: Hitachi, IBM, 

NEC, Panasonic, Sony, Texel, Toshiba, and CD- 
Technology. SCSI adapter support includes 
Adaptec, Future Domain, DPT, and IBM adapters. 

More display drivers are also provided in OS/2 
2.1, with seamless video drivers included for 13 
SVGA adapters including Tseng, ATI, Western 


Digital, Headland, and Trident, 8514/A support is 
now provided on 32-blt seamless drivers. Other sup¬ 
ported video modes are VGA, XGA, and XGA-2* 

Depending on the driver and the hardware configu¬ 
ration, these drivers can support resolutions as high 
as 1024-by-768 with 256 colors and 8OQ-by-6O0 with 
65,536 colors. 

The 32-bit model removes the 64K 
segment limits, increasing the limits on 
most resources including the number 
of definable points and handles. 


PRESENTATION MANAGER 

A new 32-bit graphics engine, first available with the 
Service Pak in October 1992, gives faster, more accu¬ 
rate graphics performance. The major changes are: 

* 32-bit model 

* Increased limits 

* New GpiPolygons API 

* Addition of Palette Manager 

* ISO-compliant fonts 

* Improved performance 

* 32-bit seamless drivers. 
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Figure h OS/2 2,1 system components overview 


The 32-bit model removes the 64K 
segment limits, increasing the limits on 
most resources including the number 
of definable points and handles* Tables 
1 and 2 show how some limits have 
been increased* 

The new GpiPolygons API improves 
high-speed drawing of polygons; the 
32-bit implementation removes prior 
restrictions and provides a faster, more 
powerful mechanism for drawing one 
or more polygons* (For more informa¬ 
tion about the GpiPolygons API, see the 
OS/2 2.0 Programming Guide , Vol. 3.) 

The palette manager allows devel¬ 
opers to take full advantage of SVGA 
and XGA drivers displaying 256 col¬ 
ors* Applications can now define their 
own colors instead of relying on 
dithering or closest fit. For more infor¬ 
mation, see the OS/2 2.0 Programming 
Guide , Vol 3. 

Another change to the graphics 
engine is the introduction of ISO fonts 


that conform to the ISO 9241-3 stan¬ 
dard* Use of these fonts is optional; 
however, the System Proportional font 
is replaced in OS/2 2*1. All other ISO- 
compliant fonts are provided in addi¬ 
tion to the original OS/2 fonts. 

The performance of the graphics 
engine has been improved by the 
removal of many "thunks" within the 
system. Also, many graphics opera¬ 
tions were enhanced for better perfor¬ 
mance 

Another important addition with 
the new graphics engine is the ability 
to develop 32-bit seamless drivers. 
These drivers provide better perfor¬ 
mance than their 16-bit counterparts. 
Note that in addition to the new 32-bit 
drivers, 16-bit drivers are still support¬ 
ed by OS/2 2.1. 

WORKPLACE SHELL 

Many improvements have been made 
to the Workplace Shell. The icons of 


Workplace Shell objects can now be 
changed by dragging and dropping 
any icon or object onto the General 
Page in the objects' settings. In addi¬ 
tion, desktop notebooks now use a spi¬ 
ral binding instead of a solid binding* 
For security purposes, a new option 
a 1 low's users to lock up OS/2 automat¬ 
ically on system startup. The WPS also 
has improved memory usage and 
improved .INI file handling* 

Warning: If you have written Work¬ 
place Shell drag and drop code under 
OS/2 2.0, the w'ay the ancestor classes 
respond to the jipDragflver method has 
changed for OS/2 2.1* Specifically, the 
parent _wpDragDver method will return 
DOR JEYERDRQP if the ancestor classes can¬ 
not accept the source objects. Conse¬ 
quently, code must be written so that 
the parent ,wpDragDver method is called 
first and if the resultant Drop indicator 
is not DQRJEVERDROP, then the method 
may continue its processing. 
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Resource Type 

16-bit 

32-bit 

Points in a polyline 

64K (data) 

128MB (points) 

GP1 paths 

1400 points 

SMB points 


Table 1 . Comparison of limits of 16-bit and 32-bit graphics engine 


OS/2 session. This change lets applica¬ 
tion developers further customize DOS 
sessions for test scenarios. Other 
enhancements include the updating of 
DPMI to be a subset of the 1.0 standard 
and MSCDEX audio support in the vir¬ 
tual CD-ROM driver. 


i 

Resource Type 

32-bit 

i 

r 

PS/DC handles 

16K 


Bitmap handles 

64K 


Region handles 

64K 


Font handles 

64K 


Table 2. 32-bit handle limits 


DOS SUPPORT 

Several enhancements have been made 
to DOS support in OS/2. A second 
thread has been introduced into the 
DOS sessions to allow for better com¬ 
munications and better synchroniza¬ 
tion of audio and video in multimedia 
applications. This function can be 
enabled with the DOS setting INT.DUR- 
ING.IO. Another new setting, DOS.AUTOEX- 
EC, allows individual AUTOEXEC.BAT files 
to be specified for each DOS or WIN- 


WIN-OS/2 3.1 

WIN-OS/2 support in OS/2 has been 
updated to support Windows 3.1 appli¬ 
cations. An enhanced compatibility 
mode also lets many enhanced-mode 
Windows applications run. However, 
applications that require a VxD-type 
device driver will not run. Performance 
in WIN-OS/2 has been improved, espe¬ 
cially the clipboard and DDE functions. 
WIN-OS/2 3.1 also provides most of the 
applets shipped with Windows 3.1, and 


LinkRight by Rightware Inc. 

The only file transfer 
utility for OS/2. 

LinkRight is a parallel port and serial port file transfer 
utility made especially for OS/2. The OS/2 versions are 32 
bit, multi-threaded tasks. For a single low price, you can 
get a PM version, OS/2 command line version, and DOS 
version. 

Copy files and EAs to/from OS/2 to/from DOS systems. 
Subdirectories, hidden, eystem files, and newer files can 
be selectively copied. 

Batch file generation. Mark and immediately send files, or 
mark files and save them to a list of files for later transfer. 
Features compression for faster transfers. Uses CRC 
checking to insure accurate transfers. Full support for long 
file names and HPFS. 

Copy the OS/2 operating system from one system to 
another in accordance with your licensing agreement with 

IBM. 

Compatible with LapLink cables. 

For purctuising information caU your favorite software distributor 
or Rightware Inc. (301) 762-1151. 

OSf2 is a rejjatered trademark of International Business Machines Corporation. 
LapLink ht a registered trademark of TVaveling Software. LinkRight is a 
copyright of Ri^itware Inc. 


Moving up to OS/2 
from Windows? Let 
CUA Controls Library/2 
deliver your GUI baggage. 

If you’re moving up to more powerful OS/2' from 
Windows? now you ean have the same user interfaces for 
both new and existing applications. 

With CUA™ Controls Library/2 (CCL/2). 

Its a 16-hit program that quickly generates familiar 
OS/2 2.0 GUIs for applications in OS/2 1.3 and Windows 
3.0 and 3.1. 

It provides consistent interfaces across platforms, so 
your end users will quickly learn new applications. 

GCL/2 contains the code for seven key Gl I screens. 
Its code you won’t have to write. It’s also code you can 
reuse. Over and over again. 

hat’s more. CCL/2 w ill save you money. Because 
there are no runtime charges for redistribution of DLLs. 

And because now its available at the low price of 
only $149. To order, call I 800 342-6672. 

For information, fax I 919 469-4423. 

So get moving. With CCL/2. ==r= T = 

IBM and OS/2 are registered trademarks and CUA is a trademark ol Internationa) 
Business Machines Corporation Windows is a trademark ot Microsoft Corporation 
©1993 IBM Corp 
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a new function allows OS/2 and DOS 
applications to be started from within a 
Windows session. WIN-OS/2 3.1 also 
includes multimedia extensions as well 
as Truetype font support, provided in 
addition to Adobe font support. 


LAPTOP SUPPORT 

On systems that support the APM 
(Advanced Power Management) stan¬ 
dard, OS/2 2,1 provides power-man¬ 
agement capabilities and a power applet 
to monitor battery status, PCMCIA sup¬ 
port is also provided; through socket 
and card services, PCMCIA cards can be 
removed and replaced while the 
machine is on. Interfaces allow device 
drivers to be allocated dynamically, 

MMPM/2 

OS/2 2.1 includes Multimedia Presen¬ 
tation Manager/2, a set of extensions 
that adds multimedia functions to 
OS/2 including image and audio sup¬ 
port, a multimedia control interface, 
support of various devices, system 
sounds, and several multimedia 
applets. Applets included with OS/2 
2.1 that were not available with 
MMPM/2 1.0 are a wave editor and the 
Ultimotion software motion video 
player. For more information about 
MMPM/2, see the References section. 

PERFORMANCE IMPROVEMENTS 


The following APIs have been added to OS/2. For more information, consult 
the online references available with the toolkit. 

DosProtectCLose 

ypAddPoyerViewPage 

Do s P rotectEa mk tt rifoute 

ypChangePowerState 

DosProtectOpen 

wpEjectDisk 

DosProtectQueryFHState 

upLockDrive 

DosProtectQueryFilelnfo 

vpPower 

DosProtectRead 

wpQuery AssociatedProgram 

DosProtectSetFHState 

upQuery AutoRefresh 

DosProtectSetFilelnfo 

upQueryDefStatusViev 

DosProtectSetFileLocks 

wpQueryDrivelockStatus 

DosProtectSetFilePtr 

yppueryPowerConfirmation 

DosProtectSetFileSize 

wpQueryPowerManagement 

DosProtectWrite 

ypQueryRefreshftate 

WinChecklnput 

yp$etA ssociatedFilelcon 

WinLockPointerUpdate 

ypSetAutoRefresli 

WinLockupSystem 

wpSetAutoRefresh 

WinQuerySysPointerData 

wpSetDefStatusView 

VinSetPointerQyner 

ypSetPowerConfirmation 

VinSetSy sPointerData 

v pSetPowerHanagement 

VinUnlockSystem 

ypSetftefreshRate 


Extensive improvements have been wpAddPoyerPage 
made to 05/2's performance, including a 
reduction in the working set of OS/2, Table 3, New OS/2 APIs 
HPFS improvments, and scheduler and 

loader changes that provide faster execu- FOR PROGRAMMERS ONLY 
tiorv In addition, there have been The MMPM/2 Toolkit is now a part of the 
changes in some CONFIG.SYS parame- base OS/2 Toolkit; it does not need to be 

I WIN-OS/2 support in OS/2 has been updated to 
support Windows 3. / applications. 


SUMMARY 

OS/2 2.1 continues to build on the 
foundation established by OS/2 2.0, 
providing a solid base for running and 
developing applications for DOS, 
OS/2, and Windows. Strengths include 
new 32-bit interfaces and the object-ori¬ 
ented System Object Model. 


ters to improve performance in memory- 
constrained environments. For detailed 
information about these changes, consult 
the OS/2 2.1 Technical Update Redboot 


purchased separately. Also, several APIs, 
shown in Table 3, have been added to 
OS/2. For more information, consult the 
online references available with the Toolkit. 
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Do these quotes sound familiar? 


“It doesn't crash 
in the debu gg er!" 

“Exactly, what 
did you do?’ 


“1 can't reproduce it!" 


“Where should 1 put 
WinGetLastError?' 


“Why does WinDefWindowProc 
generate an error? 

It must be a 
configuration problem!’ 


Introducing the API Debugger which gives Answers, not Guesses 


Error Manager 

32-bit Include 1 header file. 

Version 2.0 Link 1 DLL. 

for OS/2 2.X Set 1 environment variable. 

- Finds intermitent errors without the Debug Kernel. 

- Logs messages to a File, pipe or our PM viewer. 

- Works with optimized code in realtime situations. 

- notifies your window procedure or callback function 

- Supports both FM and Fullscreen programs 

- Enables event-driven error handling 

- Invaluable for Debug, QA Test and Production cycles 


Q Sufi £ GUI Stream Viewer 


Fite Edit Options 


Session started on 1/11/93 al 23:17:34 3 


WinOelWmdowRoclJ tjefieraleil efrof d$10 |0xl2Q2] - Invalid switch handle 
In Hie BASEWINLC al line 75. 

Suspect WinCreateSldWindowf| in Hie BAREWIH.C at line 103. 

Error occurred while processing WM_GREATE (0x0, OxlGCAOFCC] 


DosReatf | generated error J09 IQxOOGDJ 
in file PIPEHAND.C at Ur* 21. 

This occurred 10 consecutive limeaj 


Broken pipe 


Includes a PM Viewer, 

Pointer Validity API and a 
Free copy of Command Line 


$225 
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NOW, DO YOU HAVE 
ENOUGH ROOM 10 USE IT? 


If you’re running OS/2, you’ve probably discovered how much 
disk space your powerful new operating system demands. 

Not to worry. 

With Stacker® for OS/2 & DOS, you can quickly and safely 
double the capacity of your hard disk to take full advantage of 
OS/2’s power. 

Using Stac* Electronics’ patented, award-winning Stacker LZS 
technology. Stacker instantly and transparently compresses all your 
data, storing it more efficiently so you have more room to work. 

That’s all there is to it! You can install Stacker in minutes and 
access all your compressed files at any time, whether you boot 
from OS/2 or DOS. 


And, with the Stacker Optimizer you can quickly defragment 
your Stacker drives to get the best possible performance. Stacker 
works on disks as large as 1 gigabyte, giving you up to 2 gigabytes of 
disk capacity. And, it even comes with a simple Unstack command 
that returns your system to its original, uncompressed state. 

New Stacker for OS/2 & DOS. Think of it as adding space to 
your OS/2 workplace. 


CALL NOW FOR MORE INFORMATION 
1-800-522-STAC, ext. 8207 
or 619-431-7474 
Fax 619-431-9616 



it tralmudoof Sen Fktnm OW»i«| 











32-Bit 

OS/2 2.1 supports many popular CD-ROM drives and enhances application compatibility for DOS CD-ROM appli¬ 
cations. A layered CD-ROM device driver design illustrates how SCSI and non-SCSI attached CD-ROM drives are 
supported. BY FRANK SCHROEDER and RICK EFRUSS 

CD-ROM Support in OS/2 2.1 



V he popularity of CD-ROM drives has 
M Increased significantly in the past year and 
m the trend is expected to continue. This 
increased popularity can be attributed to several 
factors—increasing numbers of CD-ROM software 
titles, the continuing evolution of multimedia, and 
the increased use of CD-ROM discs as a conve¬ 
nient storage medium for large quantities of data. 
Computer software manufacturers have increased 
their use of CD-ROM discs as a cost-effective 
means of distributing software products and tech¬ 
nical information to customers. 

With the growing popularity of CD-ROM, 
emphasis has been placed on enhancing CD-ROM 
support in OS/2. While in OS/2 2.0, CD-ROM 
support is limited in the number of drives sup¬ 
ported and the level of compatibility with DOS 
applications, OS/2 2.1 support has been enhanced, 
OS/2 now supports many popular CD-ROM dri¬ 
ves; the level of DOS CD-ROM application com¬ 
patibility has also been improved. 

This article describes the CD-ROM enhance¬ 
ments in OS/2 2.1. A layered CD-ROM device dri¬ 
ver model is described; topics ranging from DOS 
application compatibility to installation are pre¬ 
sented, and a list of supported CD-ROM drives is 
included. 

0S/22.0 

In OS/2 2.0, support for CD-ROM hardware and 
software is limited. The CD-ROM device driver 
(CDROM.SYS) supports only IBM and IBM-com¬ 
patible CD-ROM drives by Toshiba. Drives from 
other manufacturers are not supported. 

Users with unsupported CD-ROM drives can 


work around this limitation with the OS/2 VM 
boot feature, accessed with the "DOS from Drive 
A:" icon in the Command Prompts folder. The VM 
boot feature allows the user to boot a native ver¬ 
sion of DOS in a full-screen session under OS/2. 
The booted DOS session uses the native DOS CD- 
ROM device driver that ships with the CD-ROM 
drive. Access to the CD-ROM drive is possible ordy 
through the booted DOS session; the drive cannot 
be accessed from an OS/2 or WIN-OS2 session. 

The virtual CD-ROM device driver 
(VCDROM.SYS) in OS/2 2.0 supports only some 
of the programming interfaces defined in the DOS 
CD-ROM Extensions (MSCDEX). Although many 
DOS CD-ROM applications work properly in OS/2 
2.0, those that use unsupported DOS CD-ROM 
extensions will fail. (The terms "DOS CD-ROM 
Extension" and "Microsoft CD-ROM Extension" 
[MSCDEX] are used interchangeably and refer to 
the same set of programming interfaces.) 

OS/22.1 

OS/2 2.1 offers more extensive support for CD- 
ROM drives and CD-ROM applications. Device 
driver support is provided for most of the popular 
SCSI-attached CD-ROM drives. Figure 1 shows a 
complete list of supported CD-ROM models. 

The CD-ROM device drivers in OS/2 2.1 fully 
exploit the capabilities of each CD-ROM drive. 
Data and audio support are provided for all mod¬ 
els, CD-ROM XA support is provided for those 
models that support the CD-ROM XA storage 
standard, which enables the interleaving of audio, 
video, and standard file system data. It is the stor¬ 
age format used in Kodak's Photo CD technology. 



Frank Schroeder 



Rick Efruss 
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Manufacturer 

Model 

Interface 

OS/2 CD-ROM Device Drivers 

Hitachi 

CDR-1650S 

SCSI-1 

OS2CDROM.DMD 

HITCDS1.FLT 


CDR-1750S 

SCSI-1 

OS2CDROM.DMD 

HITCDS1.FLT 


CDR-3650 

SCSI-1 

OS2CDROM. DMD 

HITCDS1.FLT 


CDR-3750 

SCSI-2 

OS2CDROM.DMD 


IBM 

CD-ROM I 

SCSI-1 

OS2CDROM.DMD 

TOSHCDS1.FLT 


CD-ROM II 

SCSI-2 

OS2CDROM.DMD 


NEC 

CDR-25 

SCSI-1 

OS2CDROM.DMD 

NECCDS1.FLT 


CDR-36 

SCSI-1 

OS2CDROM.DMD 

NECCDSl.FLT 


CDR-37 

SCSI-1 

OS2CDROM. DMD 

NECCDSl.FLT 


CDR-38 

SCSI-2 

OS2CDROM. DMD 



CDR-72 

SCSI-1 

OS2CDROM.DMD 

NECCDS1.FLT 


CDR-73 

SCSI-1 

OS2CDROM.DMD 

NECCDS1.FLT 


CDR-74 

SCSI-1 

OS2CDROM.DMD 

NECCDS1.FLT 


CDR-74-1 

SCSI-2 

OS2CDROM.DMD 



CDR-82 

SCSI-1 

OS2CDROM.DMD 

NECCDSl .FLT 


CDR-83 

SCSI-1 

OS2CDROM.DMD 

NECCDSl.FLT 


CDR-84 

SCSI-1 

OS2CDROM.DMD 

NECCDSl.FLT 


CDR-84-1 

SCSI-2 

OS2CDROM.DMD 


Panasonic 

CR-501 

SCSI-2 

OS2CDROM.DMD 



LK-MC501S 

SCSI-2 

OS2CDROM.DMD 


Pioneer 

DRM-600 

SCSI-1 

OS2CDROM.DMD 



DRM-604X 

SCSI-2 

OS2CDROM.DMD 


Sony 

CDU-541 

SCSI-2 

OS2CDROM.DMD 



CDU-561 

SCSI-2 

OS2CDROM.DMD 



CDU-6111 

SCSI-1 

OS2CDROM.DMD 

SONYCDS1.FLT 


CDU-6211 

SCSI-2 

OS2CDROM. DMD 



CDU-7211 

SCSI-2 

OS2CDROM.DMD 


Texel 

DM-3021 

SCSI-1 

OS2CDROM.DMD 

SONYCDS1.FLT 


DM-3024 

SCSI-2 

OS2CDROM.DMD 



DM-5021 

SCSI-1 

OS2CDROM.DMD 

SONYCDS1.FLT 


DM-5024 

SCSI-2 

OS2CDROM.DMD 


Toshiba 

XM-3201 

SCSI-1 

OS2CDROM. DMD 

TOSHCDS1.FLT 


XM-3301 

SCSI-2 

OS2CDROM.DMD 



XM-3401 

SCSI-2 

OS2CDROM.DMD 



Figure l CD-ROM drives supported by OS/2 2. 7 


which stores photographic images on a 
CD-ROM disc. 

To increase COS CD-ROM applica¬ 
tion compatibility, OS/2 supports the 
full set of application programming 
interfaces defined by Microsoft CD- 
ROM Extensions 2*21. A new DOS set¬ 
ting, INT_DURBG_I0, allows faster perfor¬ 
mance of DOS multimedia applications. 

A layered CD-ROM device driver 
model simplifies device driver develop¬ 


ment for both SCSI and non-SCSI CD- 
ROM drives. Several CD-ROM manu¬ 
facturers use this model to develop 
OS/2 device drivers that support their 
popular non-SCSI CD-ROM drives. 

A system view of OS/2 2*1 CD- 
ROM components and their relation¬ 
ships is illustrated in Figure 2. The fol¬ 
lowing sections give an overview of the 
CD-ROM subsystem and the responsi¬ 
bilities of each component* 


The Virtual CD-ROM Device Driver The 

virtual CD-ROM device driver 
(VCDROM.SYS) provides the compati¬ 
bility layer for DOS applications that 
require CD-ROM API services. It con¬ 
sists of two parts: a generic OS/2 virtu¬ 
al device driver (an operating system 
extension responsible for separating the 
activity of multiple DOS sessions) and 
a DOS device driver. The virtual device 
driver model consists of a dynamic link 
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library with separate instance data for 
each DOS session. 

The virtual device driver portion of 
VCDROM.SYS is responsible for servic¬ 
ing the DOS CD-ROM Extensions soft¬ 
ware interrupt (INI 2Fh) interface. DOS 
applications use the AH register for the 
DOS CD-ROM Extension function code 
(15h) and the AL register for the com¬ 
mand code, as shown in Figure 3. Para¬ 
meters to the DOS CD-ROM Extensions 
API are passed in the general-purpose 
registers. (This API is described in fur¬ 
ther detail in the CD-ROM Program¬ 
mer's Guide for MS-DOS CD-ROM 
Extensions 221.) 

The DOS CD-ROM Extensions 
enable DOS applications to determine 
the number of CD-ROM drives 
installed; to navigate the volume, path, 
and directory structures; and to man¬ 
age the files stored on a CD-ROM disc. 
The virtual device driver routes the 
DOS CD-ROM Extensions request to 
the OS/2 CD-ROM file system. 

The DOS device-driver portion of 
VCDROM.SYS handles DOS INT 21h file 
system requests to the CD-ROM drive. 
All requests—for example, reading a 
file from a CD-ROM disc—are routed 
from the DOS device driver to the 
OS/2 CD-ROM file system. The virtual 
CD-ROM device driver passes requests 
to the OS/2 CD-ROM file system using 
the virtual device helper services. 

Additional information on the virtu¬ 
al CD-ROM device driver and the vir¬ 
tual device helper services can be 
found in the Virtual Device Driver Refer¬ 
ence of the OS/2 Technical Library. 

The CD-ROM File System . The OS/2 CD- 
ROM file system (CDFS.IFS) is a file 
system driver that understands how 
data is stored on the CD-ROM disc and 
uses the installable file system mecha¬ 
nism to attach to and receive requests 
from the OS/2 file system. The primary 
method of storage and retrieval, the 
High Sierra/ISO-9660 format, specifies 
precisely how volume-, directory-, 
path-, and file-specific information is 
arranged on the media. 

CDFS.IFS uses the file system helper 
services to pass data and audio com¬ 


mands to the CD-ROM device manag¬ 
er. The helper services convert each 
requested operation into a device driver 
request packet that is passed to the CD- 
ROM device manager. For example, if 
CDFS.IFS receives a request to read data 
from a file, it converts the file-system 


read request into the appropriate physi¬ 
cal sector read request, which is then 
processed by the device manager. 

The CD-ROM Device Manager. The 

OS/2 CD-ROM device manager 
(OS2-CDROM.DMD) is a generic 
block-device driver for CD-ROM dri¬ 


ves that comply with the American 
National Standards Institute (ANSI) 
SCSI-2 standard X3T9.2/86-109 (SCSI- 
2 draft of proposed ANSI Revision 
lOg). It provides generic data and 
audio support for drives that support 
the command set specified in the 


standard. Vendor-unique CD-ROM 
XA support and multisession Kodak 
Photo CD support are provided for 
selected drive models. 

The CD-ROM device manager pro¬ 
vides a uniform interface between its 
clients and adapter device drivers. 
Clients of the device manager include: 
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Subsystem 
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File System API 


OS/2 CD-ROM 


DOS CD-ROM 

Application 


Application 
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DOS MSCD001 
Device Driver 
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Figure 2. OS/22.1 CD-ROM component hierarchy 
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Command 

Function Description 

00h 

Get number of CD-ROM drive letters 

Olh 

Get CD-ROM drive device list 

02h 

Get copyright file name 

03h 

Get abstract file name 

04h 

Get bibliographic file name 

OSh 

Read VTOC 

06h 

Reserved 

Q7h 

Reserved 

OSh 

Absolute disc read 

09h 

Absolute disc write 

Oah 

Reserved 

Obh 

CD-ROM drive check 

Och 

MSCDEX version 

Odh 

Get CD-ROM drive letters 

Oeh 

Get/set volume descriptor preference 

Ofh 

Get directory entry 

10K 

Send device request 

llh-OFFh 

Reserved 


Figure 3 1 MSCDEX Version 221 command codes and function descriptions 


• OS/2 applications 

■ Multimedia Presentation 
Manager/2 (MMPM/2) 
applications 

• The virtual CD-ROM device 
driver 

• The CD-ROM installable file 
system. 

OS/2 applications and the MMPM/2 
subsystem communicate with the device 
manager using the OS/2 file system API 
and Categories 80 and 81 lOCtl services, 
as shown in Figure 4 

DOS applications communicate 
indirectly with the CD-ROM device 
manager, going through the virtual 
CD-ROM device driver. VCDROM.SYS 
converts DOS CD-ROM extensions and 
DOS file system requests into an OS/2 
file system (or category 80 or 81 lOCtl) 
request which is then routed to the 
CD-ROM device manager using the 
virtual device helper services. 

The CD-ROM file system communi¬ 
cates with the CD-ROM device manag¬ 
er using the request packet interface 
defined in /he OS/2 23 Phy$ical Device 
Driver Reference mpnuat 

The interface between the device 
manager and adapter device drivers 
adheres to the adapter-device driver 
interface defined in the OS/2 2.0 Stor¬ 
age Device Driver Reference Manual spec¬ 
ification. The device manager converts 
a request from its client into a SCSI-2 
command descriptor block and routes 
the SCSI-2 command to the specified 
adapter device driver. 

The device manager is an installable 
block-device driver loaded with a 
DEVICE= statement in CONFIG.SYS. It 
replaces CDROM.SYS, the CD-ROM 
device driver shipped in OS/2 2.0. 

SCSI-2 Emulation Filters , A SCSI CD- 
ROM target device with vendor-unique 
commands not supported in the SCSI-2 
standard requires a SCSI-2 emulation 
filter (.FLT), as shown in Figure 1. The 
emulation filter maps SCSI-2 com¬ 
mands received from the device man¬ 
ager to the vendor-unique commands 
supported by the target device. This 
support is required to enable audio sup¬ 


port on CD-ROM drives that adhere to 
the SCSI-1 standard because the SCSI-1 
standard does not define a standard 
command set for audio control. 

A SCSI-2 emulation filter is required 
for each vendor-unique CD-ROM 
drive. Typically, a CD-ROM manufac¬ 
turer uses the same vendor-unique 
command set for all its CD-ROM dri¬ 
ves; one filter driver is therefore 
required for each manufacturer. 

The filter driver receives SCSI-2 com¬ 
mands from the CD-ROM device man¬ 
ager, converts the command to its ven¬ 
dor-unique equivalent, and routes the 
filtered command to the SCSI adapter 
device driver. If data returned with the 
command needs to be filtered, the filter 
driver regains control when the request 
is complete, converts the outgoing data 
to its SCSI-2 equivalent and returns to 
the device manager. The filtering 
process is transparent to the device 
manager and the adapter device driver. 

SCSI Adapter Device Drivers , A SCSI 
adapter device driver {.ADD) contains 
the hardware-specific modules required 
to program the SCSI adapter that con¬ 


trols the CD-ROM drive. An OS/2 SCSI 
adapter device driver is needed to sup¬ 
port a SCSI-attached CD-ROM drive in 
OS/2. The generic INT 13 device driver 
(IBMINT13.113), which can be used to 
support a SCSI attached fixed disc, can¬ 
not be used to support a CD-ROM 
drive. 

The SCSI-2 emulation filter and the 
SCSI adapter device driver adhere to 
the adapter-device driver interface 
defined in the OS/2 2.0 Storage Device 
Driver Reference Manual. 

OS/2 2.1 comes with device drivers 
for SCSI adapters from IBM, Adaptec, 
DPT, and Future Domain. In addition, 
OS/2 device drivers for SCSI adapters 
from Always Technology, BusLogic, 
MediaVision, Mylex, Tranter, and 
UltraStor are available from either the 
manufacturer or third-party developers. 

Non-SCSI CD-ROM Adapter Device Drivers . 

Several leading CD-ROM drive manu¬ 
facturers use proprietary, non-SCSI, host 
adapter interfaces for CD-ROM drives. 
To support a non-SCSI CD-ROM drive, 
the adapter device driver must emulate 
a SCSI-2 target device. This enables the 
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DOS 


OS/2 


Category Function 

Category 

Function 

Q2h 

00h 

***(7) 


02h 

Olh 

SOh 

70h 

02h 

04h 

81h 

60h 

02b 

Q6h 

80b 

SOh 

02b 

07h 

SOh 

63h 

02h 

OSh 

SOh 

78h 

02h 

09h 

«*( 8 ) 


Q2h 

Oah 

81h 

6ih 

02h 

Obh 

8th 

62h 

02b 

Och 

81 h 

63h 

Q2h 

Oeh 

80h 

79h 

02h 

15ti 

81 h 

65h 

03h 

OOh 

SOh 

44h 

03h 

Olh 

80h 

46h 

03b 

OSh 

SOh 

40h 

03h 

03h 

sih 

40h 


***(1) 

80h 

61h 


* w (2) 

SOh 

72h 



SOh 

m 


***(4) 

81b 

50h 


***(5) 

81 h 

SIN 


***(&} 

81 h 

52h 


Notes 

L Command is not available in DOS. 

2. DOS extended device driver command 130h 
3* DOS extended device driver command 131h 
4. COS extended device driver command 132h 

Figure 4 . DOS to OS/2 2 1 CD-ROM IQCtl mapping 


IOCtl/Command Description 

Return address of device header 

Return location of head 

Return audio channel information 

Return device status 

Return sector size 

Return volume size 

Return changed media code 

Return audio disc information 

Return audio track information 

Return audio subchannel Q information 

Return UPC code 

Return audio status information 

Eject disc 
Lock/unlock door 
Reset drive 

Audio channel control 

Identify CD-ROM driver 

Read long 

Seek 

Play audio 
Stop audio 
Resume audio 


5, DOS extended device driver command 133h 
6* DOS extended device driver command 136h 

7. Command is not available in OS/2 21 

8. Corresponds to OS/2 block device driver command Dlh 


CD-ROM device manager to issue a 
common command set to its target 
devices, regardless of whether a target 
device directly supports the SCSI-2 com¬ 
mand set or the attached host adapter is 
SCSI or proprietary. The incoming com¬ 
mand and the return sense data must be 
emulated by the driver* 

Non-SCSI CD-ROM adapter device 
drivers adhere to the adapter-device 
driver interface defined in the OS/2 2,0 
Storage Device Driver Reference Manual 
specification. 

CD-ROM GENERIC IOCTLS 

OS/2 provides an API called device 


I/O control (DosDevIOCtl), which enables 
applications to communicate directly 
with OS/2 device drivers. The OS/2 
IQCtls are specified by a category code 
and a function code. For CD-ROM sup¬ 
port the category 80h IQCtls control 
data access to the drive, while category 
81 h IQCtls control audio features of the 
drive. These IQCtls are routed from the 
application to the CD-ROM device 
manager* The CD-ROM IQCtls are fur¬ 
ther described in the 1RM PS/2 CD- 
ROM H Technical Reference manual. 

The DOS operating system provides 
an equivalent application programming 
interface called I/O Control (IQCtl) so 


DOS applications can communicate 
directly with device drivers. The BIT 21h 
function 44h call is translated by the DOS 
device driver portion of the virtual CD- 
ROM device driver to a virtual device 
helper, which is then routed to the CD- 
ROM device manager. Additional infor¬ 
mation about the DOS IQCtl interface 
can be found in Appendix C of the DOS 
5.0 Technical Reference manual 

The COS IQCtls are specified as 
belonging to either the read (02h) or 
write (Q3h) categories and are further 
subdivided into function codes, which 
correspond to the activity that the 
application is requesting of the device 
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EMS_ HI GH_ 0S_MAP_RE GI ON 
EMS_LQW_OS_M AP_REG ION 
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HW_NOSOUND 
HW_ROM_TO_RAM 
HW_TIMER 
IDLE_ SECONDS 
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KBD_ AL THOME_BYPASS 
KBD_0UFFER_EXTEND 
K8D_CTRL_BYPASS 
KBD_RATE^LOCK 
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MEM_ INCLUDE.REG IONS 
MOUSE_EXCLUSIVE„ ACCESS 
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Description 

Set ON to allow Interrupts during file 
reads and writes. Whan set to off, 
do® programs wilt not receive 
interrupts until alter read/write Is 
done. This property should be set ON 
for Multimedia applications. 


Save j j Default | ; Cancel | Help 
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driver. Figure 4 illustrates the mapping 
of DOS CD-ROM IGCtls to their corre¬ 
sponding OS/2 equivalents. 

INSTALLATION 

Installation of CD-ROM device drivers 
has been simplified in OS/2 2.1, Dur¬ 
ing the initial installation of OS/2, the 
installation program automatically 
detects the presence of the CD-ROM 
drive and SCSI adapter and installs the 
required device drivers. The product 
name of the detected CD-ROM drive 
and SCSI adapter is displayed, provid¬ 
ing visual feedback to the user. 

Users who add a CD-ROM drive to 
their system after OS/2 has been 
installed can use the Selective Install 
feature to install the required device 
drivers. 

After installation, the CONFIG.SYS 
file will contain the following state¬ 
ments: 

DEVICES:\OS2\HDOS\VCDROH.SYS 
IFS=C:\0S2\CDF5.IFS /Q 
BISEDEV-3M2SCSIJDD 
DEVICES:\0S2\0S2CDR0M.DHD /Q 

Jn these statements, VCDROM .SYS repre¬ 
sents the virtual CD-ROM device dri¬ 
ver for DOS application support and 
CDFS.IFS represents the CD-ROM file 
system driver. IBM2SC5IJDD is the 
adapter device driver for the IBM PS/2 
SCSI Adapter. (This statement varies 
depending on the SCSI adapter 
installed.) 0S2CDRQH.DHD is the OS/2 CD- 
ROM device manager. 

The adapter device driver is loaded 
with BASEDEK while the CD-ROM device 
manager is loaded with the DEVICE- 
statement. For Cl>ROM drives that use 
the SCSI-1 interface, a BASEDEY- statement 
is also required to load the SCSI-2 emu¬ 
lation filter. {Figure 1 gives a complete 
list of supported CD-ROM drives and 
their associated device drivers.) 

DOS SETTINGS FOR CD-ROM 
APPLICATIONS 

In OS/2 2.0, one thread is used in each 
DOS session for all activity, including 
hardware interrupt simulation. This sin- 


Figure 5. INT_DURING_IO DOS setting 

gle-threaded implementation limits the 
performance of DOS multimedia appli¬ 
cations. The limitation is noticeable in 
DOS applications that require synchro¬ 
nized audio and video; the typical result 
is breakup of the audio or video stream, 
A breakup occurs when the single 
thread is blocked in the device driver 
while waiting for a read of the CD- 
ROM to complete. When blocked, the 
thread cannot process the simulated 
hardware interrupts of the other stream. 

OS/2 2.1 adds a new DOS setting, 
INT_DURING_IQ, which alleviates this syn¬ 
chronization problem, as shown in Fig¬ 
ure 5, When INT_DURING_IO is set to ON, 
OS/2 2.1 creates a second thread so 
that hardware interrupt simulation can 
occur concurrently with input and out¬ 
put. The result is smoother audio and 
video playback for DOS multimedia 
applications. Because the INT.DURINGJO 
DOS setting adds some overhead to the 
system, it should be activated only 
when needed to make a particular 
application run successfully. 

KODAK PHOTO-CD SUPPORT 

Kodak recently introduced its Photo CD 
technology, which enables users to store 
photographic images on a CD-ROM 


disc. To support the Photo CD stan¬ 
dard, a CD-ROM drive must be able to 
read CD-ROM XA formatted sectors. 

Multisession Photo CD allows users 
to add more sets of photographs to a 
CD containing an existing set. In OS/2, 
multisession Photo CD is supported for 
the following CD-ROM drives: 

* SonyCDU-561 

* Toshiba 3401 

* Texel 3024/5024 (with Texel 
Photo CD firmware upgrade) 

* Pioneer DRM-604X (with 
Pioneer Photo CD firmware 
upgrade). 

Single-session Photo CD restricts the 
storage of images to a single set; no pho¬ 
tos can be added after the initial set. Sin¬ 
gle-session Photo CD is supported in 
OS/2 2.1 for these CD-ROM drives: 

* CD Technology Porta-Drive 
T3301 

* Hitachi CDR-3750 

* IBM CD-ROM-11 

* Sony CDU-541, 6211,7211 

* Texel 3024,5024 

* Toshiba 3301 

* NEC Multispin 38, 74-1, 84-1. 
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ERIEN-KEEPER 


(noun) 1. One who keeps the 
environment green. 2. A series of clip- 
and-save tips for keeping your business 
and home environments green. 


How to help 
impany 



■ rom the boardroom to the mail- 
room to the lunchroom to the wash¬ 
room, there may be more ways than 
you think to help your company be¬ 
come environmentally responsible: 

• Recycled office paper 

• In-house recycling programs 

• Reduced or recycled product 
packaging 

• Glassine or open window 
envelopes 

• Compact fluorescent light bulbs 

• Company coffee mugs 

• Weekly departmental newsletters 
instead of daily memos 




)ut how can you help your com¬ 
pany make these changes? Where 


can you find energy-saving, recyc¬ 
lable, and recycled materials? How 
can your company recycle its own 
waste? And how can you do it at little 
or no expense—or even save money? 

Try some of the suggestions in 
Keeping Your Company Green, written 
by Stefan Bechtel and the editors of 
Rodale Press. This how-to guidebook 
is packed with “simple, doable steps 
your company can take to help keep 
itself—and the world—green." The 
book also includes a Directory of 
Green Products and Services. For 
more information, contact Rodale 
Press at 1-800-441-7761. 

Permission granted by Rodale Press , Inc. 

The Green-Keeper series is sponsored by 
the MFI Green Project of Miller Freeman Inc. 









This article describes enhancements to printing performance in OS/22.1 with emphasis on the OS/2 LaserJet 
printer driver. We will compare and discuss new performance options in the LaserJet driver: printer memory 
usage, large buffers, printer hardware patterns, and HP-GL/2. byshixiong yang and monte copeland 


Print Performance Options in 
OS/2 2.1 Printer Drivers 




Monte Copeland 


hree things affected printing performance 
under OS/2 2.0: the addition of the 32-bit 
graphics engine component (PMGRE.DLL), 
advances in printer hardware, and changes to 16- 
bit OS/2 Presentation Manager (PM) print drivers. 
This article describes changes in OS/2 2.1 that 
affect printing, with special emphasis on the OS/2 
LaserJet printer driver. It compares new perfor¬ 
mance options in the LaserJet driver: printer mem¬ 
ory usage, large buffers, printer hardware pat¬ 
terns, and HP-GL/2. 

CHANGES AFFECTING 
PRINTING PERFORMANCE 

32-Bit Graphics Engine Component. The OS/2 graphic 
engine component (PMGRE.DLL or simply GRE) 
has been converted to 32-bit in OS/2 2.1 and was 
first introduced in the Service Pak ( previously 
referred to as the corrective service disk) for OS/2 
2 . 0 . 

The new GRE allows OS/2 to enable 32-bit PM 
device drivers while retaining compatibility with 
existing 16-bit PM device drivers. In OS/2 2.1, 
most PM video drivers are 32-bit, while most PM 
printer drivers are 16-bit. 

Because of this, printing takes some perfor¬ 
mance hits because of "thunking." A thunking 
process is a short piece of code that allows 32-bit 
functions to call 16-bit worker routines and vice 
versa. The GRE uses thunks in OS/2 2.1 to retain 
compatibility with 16-bit PM printer drivers—but 
at a cost: executing thunk code takes additional 
time. For example, a commonly run test case caus¬ 


es the GRE to call the driver function FiUPath over 
600,000 times for a single page. Each call must exe¬ 
cute thunk code. 

Most laser printers have 300 dots-per-inch (dpi) 
resolution, but new models boast 600 dpi. This 
twofold increase in resolution means a fourfold 
increase in raster data that the GRE, the printer 
drivers, and the OS/2 kernel must generate and 
send to the printer. To store a letter-sized mono¬ 
chrome bitmap at 300 dpi, for example, takes 
about 1MB of memory; at 600 dpi it takes about 
4MB of memory. 

New Performance Optimization In OS/2 2.1, the 
GRE, spooler, and 16-bit PM printer drivers have 
been optimized to improve printing performance. 
In the past, the interaction between the GRE and 
PM printer drivers was not a problem since both 
GRE and drivers were 16-bit. Now, however, 
reducing the interaction becomes an important 
issue. To improve performance, we used dynamic 
GRE dispatch tables. We also found opportunities 
in the GRE, the spooler, and PM printer drivers to 
cache memory rather than freeing and reallocat¬ 
ing it later. In several cases, this improved spool¬ 
ing time by as much as 10% to 25%. 

Dynamic GRE Dispatch Tables. One new use of the 

GRE is for dynamic dispatch table support. The 
GRE dispatch table (essentially a jump table) is an 
array of function pointers that, by default, point 
to functions in the GRE. Device drivers change the 
table and point to functions within the driver, an 
activity known as "hooking the engine." Previous- 
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Printer Compression Mode Testing 
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figure 1 . Printer compression mode 


ly, a device driver had only one chance 
to hook the engine- With dynamic dis¬ 
patch tables, however, a PM driver can 
now selectively unhook the GRE func¬ 
tions based on its initial settings {job 
properties, device context type, and so 
on) when a new printer device context 
is enabled* Reducing the number of 
hooked functions reduces the number 
of thunks to execute; thus, printing per¬ 
formance improves* 

PERFORMANCE OPTIONS IN THE 
PM PRINTER DRIVERS 

In the printer properties dialogue, the 
PM LaserJet driver offers printer mem¬ 
ory and printer page protection selec¬ 
tions. It also offers four different per¬ 
formance options in the job properties 
dialogue of the driver* The printer 
object presents both dialogues, while 
most applications present the job prop¬ 
erties dialogue before printing. 

If these options improve perfor¬ 
mance, it is logical to ask, why not 
enable them all the time? The answer 
is that some options may not improve 
performance every time; it depends on 


the application program and the con¬ 
tent of the print job. 

Printer Memory Selection and Compres¬ 
sion Mode. In OS/2 2.1, the LaserJet dri¬ 
ver needs to know exactly how much 
printer memory is available for com¬ 
pressing raster data* On the printer 
properties dialogue, specify the amount 
of memory installed in your printer 
and the page protection value. The 
memory amount should include stan¬ 
dard and expanded memory. If you are 
unsure about these values, print the 
self-test page from the printer and enter 
the values displayed there into the 
printer properties dialogue box. 

The amount of available printer 
memory affects how the LaserJet driver 
compresses raster data* PCL5-capable 
LaserJet printers allow several modes 
of data compression; the driver chooses 
the optimal mode of compression 
based on printer capabilities, available 
printer memory, and the nature of out¬ 
put data* 

The modes of raster data compres¬ 
sion are uncompressed (mode 0), run- 


length encoded (RLL mode 1), tagged 
image file format (TIFF mode 2), delta 
row compression {mode 3), empty row 
(mode 4), and adaptive mode compres¬ 
sion (mode 5). 

Mode 2 is the tagged-image file for¬ 
mat, or TIFF, a combination of mode 0 
(unencoded) and mode 1 {RLL encod¬ 
ed)* The driver selects mode 2 encod¬ 
ing when there are repeated or similar 
bytes adjacent to one another in a sin¬ 
gle raster row. 

Mode 3, the delta row encoding 
method, identifies those bytes in a 
raster row that are different from corre¬ 
sponding bytes in the preceding row* 
The driver transmits only those bytes 
that are different, then selects mode 3 
encoding when there are similar adja¬ 
cent raster rows. 

Mode 5, adaptive compression 
mode, is a mixture of all compression 
modes that can print empty or dupli¬ 
cate rows* In mode 5, the driver selects 
one compression mode per row but 
bundles up to 32K of rows into a single 
mode 5 block* Currently, only Hewlett 
Packard's LaserJet 4 printers support 
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this mode. 

The first step in choosing an optimal 
compression mode is to check the 
printer model and available memory- 
The driver studies the raster data and 


Fast System Fonts Option. In OS/2 2.0 and 
2.1, there is a fast system fonts option on 
LaserJet and IBM 4019 printer drivers. 
When the option is disabled, OS/2 sys¬ 
tem fonts are sent to the printer as raster 


Amount of System Memory 


Large Buffers Option Testing 

Describe 3.0 Generic Pg.3 


14MB 


8MB 


6MB 



100 150 £00 
Spooling Time (Seconds) 


W/O Large buffers 
w/ Large buffers 


300 


Figure 2. Large buffers option testing 


Printer Patterns Option Testing 

Printing 20 Patterns Using Excel OS/2 



Printer patterns on 

Raster mode {Compression on) 

Raster mode {Non-Compression) 


Figure 3 . Printer patterns option testing 


chooses a suitable compression mode. 
The best selection is the one that con¬ 
serves the most spool file space and the 
time it takes to transmit data to the 
printer. Figure 1 shows the different 
spool file sizes of one page of raster 
data in two applications using different 
compression modes. The diagram 
shows that compression mode can have 
a large impact on file size and that the 
optimum compression mode varies 
with different output data. 


graphics data. When the option is 
enabled, however, the printer driver 
downloads OS/2 system fonts to the 
printer where they become (essentially) 
device fonts. With a large text job (for 
example, a multipage spreadsheet} 
designed with OS/2 system fonts, print¬ 
ing speed is dramatically improved. 

Large Buffers Option This option refers 
to buffers of memory allocated from 
primary computer storage. When 
selected, it causes the PM LaserJet 


printer driver to allocate substantially 
more RAM when using the LaserJet 4 
or other 6UQ-dpi printers. Test results 
show that this option works best with 
at least SMB of RAM. 

With normal buffers, the LaserJet 
printer driver allocates a 1MB memory 
buffer to hold raster data for a letter¬ 
sized page. (The printable area for let¬ 
ter size is S.O-by-10.6 inches. At 300 dpi, 
it takes 11,250 bytes per square inch to 
hold monochrome raster data. Thus, a 
300-dpi letter-sized page fits in 954,000 
bytes.) 

In higher resolutions or for forms 
larger than letter size, 1MB is not 
enough to hold all raster data. In this 
case, the driver uses a technique called 
"banding" to partition a page into sev¬ 
eral 1MB sections, or bands. Graphic 
orders are first recorded into a journal 
file, which is played as many times as 
necessary to write the raster data into 
each band. Using a 1MB buffer, print¬ 
ing to a LaserJet 4 printer at 600 dpi, 
the driver must generate four bands for 
a letter-sized page. The driver must 
play the journal file four times to ren¬ 
der the whole page. Replaying the jour¬ 
nal file is time-consuming; printing 
with it can take up to four times longer 
than printing a 300-dpi page. 

The large buffers option increases 
the size of the banding buffer to 4MB. 
A buffer of this size is adequate for a 
600 dpi letter-sized page; the driver 
need play the journal file only once. 
While this option may adversely affect 
a low-memory system, it provides a 
performance boost for users with 
enough system memory. Figure 2 
shows test results for the large buffers 
option on computers with varying 
amounts of system memory. 

Printer Patterns Option. This performance 
option was added in OS/2 2.1 for Laser¬ 
Jet and IBM 4019 printer drivers, to 
speed spreadsheet applications that fill 
rectangular areas with shading or cross- 
hatch patterns. It uses pattern-fill capa¬ 
bilities in the printer hardware instead 
of raster patterns generated by the GRE, 
reducing the size of the spool file and 
saving transmission time to the printer. 
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When the printer patterns option is 
enabled, the printer driver hooks the 
GRE function FilLPath. When the GRE 
calls the printer driver to fill a path, it 
generates the appropriate PCL4 or 
PCL5 printer control language com¬ 
mands for the target printer. PCL5 
printers support the HP print model 
and allow pattern filling with back¬ 
ground mixing modes. This hardware 
support is adequate for almost all pat¬ 
tern-filling graphic requirements. 

The performance gain with the 
printer patterns option depends on two 
factors. First, the complexity of paths or 
regions to fill affects performance. For a 
small number of large rectangular fills, 
the option greatly reduces the size of 
the output file and increases the print¬ 
ing speed. For a large number of rec¬ 
tangular fills, however, it may overbur¬ 
den the printer's engine and decrease 
performance. Our tests show that this 
option improves performance when the 
areas to fill are of moderate complexity. 
Figure 3 shows the test results printing 
an Excel for OS/2 spreadsheet with 
pattern fills of 28 rectangular areas. 

Second, the printer processor speed 
and printer language level affects per¬ 
formance. For PCL4 printers, the option 
should only be used for simple pattern 
filling (no overlay or white filling). Fur¬ 
ther, since the pattern-filling com¬ 
mands are executed in the printer, 
overall speed increase depends on the 
speed of the printer microprocessor. 

HP-GL/2 Option. HP-GL/2 is the stan¬ 
dardized version of the Hewlett- 
Packard Graphic Language usually 
found in the company's line of plotters. 
HP-GL/2 is especially well suited for 
drawing arcs and lines because the dri¬ 
ver can efficiently generate vector 
drawing orders. Using HP-GL/2 com¬ 
mands reduces the output file size, 
increasing printing speed. When the 
HP-GL/2 option is enabled, the Laser¬ 
Jet print driver hooks the GRE func¬ 
tions for line, polyline, arc, box, area 
fill, box fill, and polygon fill. 

HP-GL/2 mode is best suited for 
print jobs that are mostly vector and 
pattern-fill commands with few raster 


operations. For example, printing a line 
drawing test case to a LaserJet 4 printer 
with mode 5 compression produces a 
136K spool file without HP-GL/2; the 
same test case with HP-GL/2 enabled 
produces a 4K spool file. Figures 4 and 
5 show the performance of HP-GL/2 in 


with HP-GL/2. At an OS/2 command 

prompt, change directory (CO) to the 1 

\SP00L\<physical name> and do a directory 5 

listing (DIR) of *.SPL with the /OD (sort by 

date) switch. The last two files contain 

the PCL5 commands generated by the 

driver. If the latter (HP-GL/2 enabled) 


Test cases 


HP-GL/2 Performance Testing 

Total Printing Time Comprison 



Printing Time (Seconds) 


W/O HP-GL/2 
W/ HP-GL/2 


Figure 4. HP-GL/2 performance: printing time comparison 


Test cases 


HP-GL/2 Performance Testing 

Output File Size Comparison 


Arc test case 


Line test case 


Pattern test case 



Output File Size (KB) 


Figure 5. HP-GL/2 performance: output file size comparison 


■ W/O HP-GL/2 
B W/ HP-GL/2 


three test cases for arc drawing, line 
drawing, and pattern filling. 

To tell if a job is suited for HP-GL/2, 
first specify printer-specific format in 
the LaserJet settings for queue options, 
then change the status to hold. Print the 
job two times, first without and then 


trial is substantially smaller than the 
former, then the job is well suited for 
HP-GL/2. 

There are some limitations to the 
HP-GL/2 option. Mixing HP-GL/2 
drawing and raster drawing can lead to 
incorrect output if one should overlay 
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the other. The order in which they are 
drawn can affect the final result. 

Patterns are treated differently 
when HP-GL/2 is enabled; the driver 
essentially ignores the setting of the 
printer pattern's performance option in 
this case. When HP-GL/2 is on, the dri¬ 
ver will always fill areas using HP- 
GL/2 commands. 

Font output may also differ slightly 
with HP-GL/2; character strings ren¬ 
dered with it may differ from strings 
rendered with system fonts, especially 
when text is clipped, rotated, or mixed 
with other graphics such as lines or 
patterns. 

Depending on job content, output 
rendered with HP-GL/2 can differ 
from the non-HP-GL/2 path. If so, turn 
off the HP-GL/2 option. 


FUTURE DIRECTIONS 

New advances in bidirectional ports 
and printers will eventually enable dri¬ 
vers to query the printer for installed 
memory and fonts, simplifying driver 
configuration and saving unnecessary 
work. We expect more application pro¬ 
grams to subclass the Workplace Shell 
printer object and provide drag-and- 
drop printing for their particular file 
formats. 

Our strategy is to move away from 
the 16-bit PM printer drivers and 
exploit the 32-bit model. The 32-bit 
print drivers and the GRE will interop¬ 
erate using the flat memory model. The 
absence of thunking combined with the 
new performance techniques described 
here promise even faster printing on 
the horizon. 


Shixiong Yang, IBM Carp., 1000 NM 
51st St., Boca Baton, Ha. 33429. Yang is a I 
staff programmer in the OS/2 advanced 
printing department at IBM, where he is 
currently working on OS/2 PM printer dri¬ 
ver development Yang holds a DIng.Sc. in 
electrical and computer engineering from 
the New Jersey institute of Technology. 

Monte Copeland, IBM Corp., WOO A/. 1/1/ 

51 st St, Boca Raton, Fla. 33429. Since 
1987, Copeland has worked at IBM as a 
tester, technical support person, tools 
writer, and conference presenter He is cur¬ 
rently a presentation print driver developer 
Copeland holds a BS in computer science 
from Florida Atlantic University. 




Client/Server 


As enterprises begin to roil out applications on client/server platforms such as OS/2, system administrators 
must manage large numbers of distributed resources such as clients, shared printers, and file servers. This 
presents an opportunity for developers of distributed system management applications. BY CHUCK MCKELLEY 

LAN NetView: 

A Programming Overview 



Chuck Me Kelley 


C lient/server architecture is characterized 
by applications executing on a large num¬ 
ber of workstations and PCs rather than on 
one time-shared mainframe or minicomputer. In 
addition to performing traditional network man¬ 
agement the administrator of a client/server net¬ 
work must deal with such problems as distribut¬ 
ing corrective sendee disks and new releases of 
software products to LAN-connected clients and 
servers, performing remote failure analysis, and 
monitoring remote system use. A few vendors 
have delivered distributed applications that help 
administrators solve these and other problems. 

Most of these distributed system management 
applications consist of two major pieces. The sec¬ 
tion of an application that contains the user inter¬ 
face is often known as a manager or managing 
program, while the PC upon which it runs is 
called a managing station. Most distributed man¬ 
agement programs also contain an agent, a pro¬ 
gram that runs on the systems to be managed. The 
systems on which the agent runs are called man¬ 
aged stations. 

Management protocols, which managers use to 
communicate with agents, run over a variety of 
transport protocols, such as the transmission control 
protocol/internet protocol (TCP/IP) and the Net¬ 
BIOS protocol. Many management applications use 
private management protocols; some, however, use 
either the simple network management protocol 
(SNMP), originally designed to manage TCP/IP net¬ 
works, or the common management information 
protocol (CMIP}, designed to manage open systems 
interconnection (OSI) networks. SNMP and CMIP 


are quite different and, until recently, most distrib¬ 
uted system management application vendors have 
had to choose between the two. In addition, most 
vendors concentrate on only a few parts of the dis¬ 
tributed system management problem, with the 
result that different system management applica¬ 
tions are incompatible and have very different user 
interfaces. Further, an application that manages 
SNMP agents may not he able to communicate with 
CMIP agents and vice versa. 

LAN NETVIEW 

With the announcement of the LAN NetView dis¬ 
tributed management products (based on Hewlett- 
Packard's Open View technology), IBM has made 
it easier for vendors to integrate distributed man¬ 
agement applications on an open-system, stan- 
dards-based framework with a single object-ori¬ 
ented user interface similar to that of the Work¬ 
place Shell. The NetView family supports 
managing stations on OS/2 and managed stations 
on OS/2, DOS, and DOS plus Microsoft Windows 
platforms. The NetView open systems API allows 
the managing station to communicate with SNMP 
and CMIP agents on a variety of IBM and non- 
IBM platforms. 

The LAN NetView family, shown in Figure 1, 
contains products upon which distributed system 
management applications can be built. The base 
product set includes a product for managing sta¬ 
tions, LAN NetView Manage, and three for man¬ 
aged stations: LAN NetView Enabler, LAN 
NetView Agents for DOS, and LAN NetView 
Agents Extended. 
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Figure 1. The LAN NetView family 

MANAGING STATION COMPONENTS 

LAN NetView Manage is installed on OS/2 
managing stations. It contains core APIs and ser¬ 
vices that allow managing applications to commu¬ 
nicate with CMIP and SNMP agents on managed 
stations throughout the network. Manage uses 
TCP/IP to communicate with SNMP agents. For 
CMIP agents, it supports CMIP over TCP/IP 
(CMOT) and CMIP over logical link control 
(CMOL). Manage also contains several compo¬ 
nents that assist applications with distributed 
management. 

Event Management Services (EMS) collects 
CMIP events and SNMP traps issued by agents on 
remote systems and routes them to any application 
registered to receive them. EMS's filter service 
allows applications to register only for events and 
traps of interest to them. In addition, an EMS agent 
logs events and retrieves event data from the log. 


The Metadata Service manages the NetView 
management information base (MIB). Agent devel¬ 
opers can use the service to store their managed 
object definitions in the MIB, w r here they are avail¬ 
able for use by application programs. Applications 
can retrieve object definitions to understand 
objects that have been added by another applica¬ 
tion or agent developer. 

The Topology Management Service (TMS) con¬ 
tains a set of discovery functions that explore the 
network and collect information about network 
nodes and links. TMS stores the information in a 
network topology database available to manage¬ 
ment applications. The collected data includes sta¬ 
tus information, which is constantly updated to 
reflect the network state. TMS can discover SNMP 
and CMIP objects accessed via TCP/IP as w r e!I as 
CMIP objects accessed via CMOL. 

Application integration and user interface func- 
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LAN 


LAN 
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Resource Managers 
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a tions are supplied by the View compo¬ 
nent, the user's port into the network 
topology. An object-oriented user inter¬ 
face much like the OS/2 Workplace 
Shell, the View component was built 
using object-oriented programming 
techniques and the OS/2 system object 
model (SOM)- There are two levels of 
integration available. Management 


dons to receive and respond to requests 
from the managing station. The Enabler 
includes the same OS/2 and LAN Serv¬ 
er requester agents packaged with 
Manage. 

CMOL agents to manage worksta¬ 
tions running DOS 5.0 or DOS 5.0 with 
Microsoft Windows 3.1 are provided 
by LAN NetView Agents for DOS. 



I An application can also be tightly coupled 
with the user interface andean use object- 
oriented programming to access topology 
information and user interface folder data. 


applications can be launched from the 
topology display by registering an ,EXE 
file with the View component's appli¬ 
cation integration service. An applica¬ 
tion can also be tightly coupled with 
the user interface and can use object- 
oriented programming to access topol¬ 
ogy information and user interface 
folder data. When a user selects an 
object in the View folders, the appro¬ 
priate SOM class is called. 

MANAGED STATION 
COMPONENTS AND PRODUCTS 

LAN NetView Manage also includes 
agents for the LAN Server 3.0 requester 
and OS/2 2.0 with the service pack and 
2,1. These agents can be used to man¬ 
age the LAN Server requester and 
operating system on the managing sta¬ 
tion. For example, the OS/2 agent can 
retrieve information about the operat¬ 
ing system, set information in the 
CONFIG.SYS file, and emit notifica¬ 
tions when exception conditions are 
detected. Manage also contains a per¬ 
formance subagent that retrieves select¬ 
ed performance information. 

The managed station counterpart to 
Manage is LAN NetView Enabler, 
which contains the subset of the LAN 
NetView Manage function needed to 
allow agents on OS/2-managed sta- 


These DOS and Windows agents are 
installed on managed stations. 

LAN NetView Agents Extended pro¬ 
vides agents for OS/2 Extended Services 
1.0 Database Manager, OS/2 LAN Serv¬ 
er 3.0, and Communications Manager/2 
1.0. The database manager agent 
exploits the administration APIs of the 
OS/2 Extended Services 1.0 Database 
Manager and the OS/2 Database Dis¬ 
tributed Connection Services/2 1.0 on 
OS/2. Applications can use this agent to 
update database configuration informa¬ 
tion, catalogue nodes, or perform any 
other administrative task for which the 
database manager provides an API. The 
LAN Server agent allows management 
applications to perform remote adminis¬ 
tration on IBM LAN Server 3.0 
requesters and servers on OS/2, with 
the Communication Manager/2 1.0 
agent doing the same for Communica¬ 
tion Manager/21,0, 

LAN NETVIEW 
MANAGEMENT PROTOCOLS 

LAN Net View-based management 
applications and agents communicate 
via the X/Open OS1 Abstract Data 
Manipulation API (XOM) and the 
X/Qpen Management Protocols API 
{XMP). The open-system XOM and 
XMP APIs are symmetric; the same API 


is used on the managing and managed 
stations. XOM allows applications and 
agents on various platforms to encap¬ 
sulate management data and requests 
in self-describing packets that can be 
decoded by any XOM-knowledgeable 
receiver. Where analogous operations 
exist, XMP permits applications to 
communicate consistently with CM1P 
and SNMP agents. While optimal per¬ 
formance is achieved with specific 
commands for CM IP and SNMP 
agents, the LAN NetView Manage and 
LAN NetView Enabler implementa¬ 
tions of XMP can map between CMIP 
and SNMP requests, hiding the multi¬ 
ple management protocols from the 
application. 

In addition to the management 
framework and agents, the LAN 
NetView family includes four manage¬ 
ment applications: a fault monitor, a 
performance monitor, a configuration 
manager, and a manager that transmits 
LAN notifications to and receives com¬ 
mand functions from a mainframe 
NetView host. 

CONCLUSION 

The LAN NetView family provides 
developers of management applica¬ 
tions and agents with a robust stan- 
dards-based framework on which to 
build distributed management applica¬ 
tions. The framework's support of mul¬ 
tiple management and transport proto¬ 
cols allows developers to concentrate 
on management applications rather 
than the mechanics of communication. 
The X/Open APIs combined with the 
LAN NetView management services 
provide a standard way to supply 
agents, one that allows applications to 
manage resources consistently. Devel¬ 
opers can share objects and integrate 
applications with the LAN NetView 
topology display. 

Charles R. McKelley, Jr., IBM LAN Sys¬ 
tems, 11400 Burnet Rd. r Austin, Texas 
78758 L McKelley is an advisory programmer 
on the LAN NetView vendor support team. 
In his 26 years with IBM t he has held vari¬ 
ous technical and management positions in 
field support and software development 
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PROGRAMMING 
WITH OS/2® 2.0 

Second Edition 



Cttent/Server 
OS/2 2 0 



By Robert Orfali and 
Daniel Harkey 

Readers raved about the first edition of this best selling 
Client/Server-OS/2 resource. Now updated with in- 
depth tutorials and sample code, this is the ideal guide 
to client/server in the 32-bit environment. Covers all 
new 2.0 functions. 


$3935,1,026 pages, paper, 0-442-10219-5 
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OS/2® 
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IBM's New Operating 
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By Lori T. Brown and Jeff Howard 
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ronment • power up with GV'2/s MiUtiipedia 
Presentation Manager/2 under Workplace. 

$24.95, 400 pages, paper with disk, 0-442-01590-9 



New! 

OS/2® 2.X NOTEBOOK 
The Best of OS/2® 
Developer Magazine 

Edited by Dick Conklin 
Foreword by Philippe Kahn, 
Borland International, Inc . 

The very best articles from OS/2 
Developer Magazine, completely 
revised! Includes product reviews, 
coding examples, user tips and 
techniques. Over 1,100 pages cover¬ 
ing software tools, graphical user 
interface, client/server and object 
oriented programming, multimedia 
and graphics and lots more. 

$3435,1,164 pages, paper, 

200 illustrations, 0-442-01522-4 


New! 

THE OS/2® 2.1 
CORPORATE PROGRAM¬ 
MER'S HANDBOOK 

By Nora Scholin, Martin Sullivan, 
and Robin Seragg 
Simplify migration from DOS and 
Windows to OS/2 2.0 and find 
valuable solutions based on modu¬ 
lar subdesigns, from function key 
assignments to pull-down menus. 
$39.95, 352 pages, cloth, 
0-442-01598-4 


WRITING OS/2® 2.0 
DEVICE DRIVERS IN C 

by Steven /. Mastrianni 
The first guide to programming 
32-bit OS/2 device drivers includes 
C source code examples, with 
optional disk. Reduces the difficulty 
and cost of writing device drivers 
for OS/2. 

$3635, 410 pages, paper with 
optional disk, 0-442-01241-5 


LOOK FOR THESE OS/2® 2.0 LIBRARY BOOKS 

from VAN NOSTRAND REINHOLD 
at major technical bookstores nationwide. 


EASY ORDERING! CALL TOLL-FREE: 1-800-544-0550. 
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VAN NOSTRAND REINHOLD 
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, X. - _v Client/Server 

Accessing and analyzing data in a variety of ways is critical in a business environment. The IBM Personal Appli¬ 
cation System/2 Version 3 is IBM's new 32-bit client/server product for decision support applications within the 
Information Warehouse framework architecture, by ron Douglas, shaun jones, and william king, jr. 


32-bit GUI Client/Server 
Application Development 
With Personal AS/2 



Ron Doughs 



Shaun Jones 



William King , Jr. 


ersonal Application System/2 Version 3 
(Personal AS/2 V3), developed by IBM's 
Programming Systems (PRGS) division, is a 
32-bit application designed for data access, query, 
data analysis, presentation, and communication of 
business results. It contains a range of tools to man¬ 
age and format data, including: 

• Table edit and browsing 

• Query 

• Data analysis and manipulation 

• Report writing 

• Chart creation 

• Task automation via iconic procedures. 
Personal AS/2 V3 is designed for business 


users and takes advantadge of OS/2 2.1 Work¬ 
place Shell functions such as drag and drop, clip¬ 
board support, and dynamic data exchange 
(DDE). 

PERSONAL AS/2 1 !3 PACKAGING 

The minimum configuration of Personal AS/2 V3 
is the base product, which provides data access, 
reporting and charting functions, and a graphical 
procedure function for generating basic applica¬ 
tions. The base product also provides run-time 
support for user applications developed with the 
optional Builder/2. Both products can be installed 
on a stand-alone PS/2 or LAN. Personal AS and 
related products are also available on the DOS 
Windows platform. 
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Figure 1. Custom window created with Builder/2 
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BUILD YOUR OWN 
OS/2 LIBRARY 
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OS/2 available from any source” 

Microsoft ITIS 

Essex Systems. Inc. 

One Central Street Phone (508) 750-6200 
Middleton, MA 01949 Fax (508)750-4699 
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Gary Slattery, Sofiunre Developer, Computer Associates 


“The best platform for 
DOS and Windows.” 

“I develop software applications for a living 
and 1 think OS/2 ‘ is a great way to do 
business.” A 32-bit, virtual memory operat¬ 
ing system, OS/2 is the ideal platform for 
developing your DOS, OS/2, Windows™ and 
even host-based applications. 

With OS/2 you can boost the power of 
your favorite DOS and Windows tools. 


IBM and OS/2 ane registered trademarks and Wor kplace Shell, C++. Com monView. 

C Set/2 and OS/2 Crash Protection are iradenwks of internation al Business Machines 
Corporation All othet products are trademarks or registered trademarks ol their respective 
companies. ©1993 IBM Corp. 


more 


plus take advantage of over 250 available 
OS/2 development tools and utilities. 
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It’s a productivity thing. 

"1 use CA Realizer to prototype new 
graphical interfaces. I write code using 
CA C++™ and ComrnonVicw™ (integrated 
with IBM’s C Set/2™ compiler) 
while I compile in the 
background. And when 
designing reports or 
planning schedules, 

I use CA-RET” 

0S/2’s pre-emptive 
multithreaded multitasking dynami¬ 
cally manages CPU time so you can run 
DOS, Windows and OS/2 apps 
concurrently in different sessions 
with maximum efficiency. That 
means you can edit in one win¬ 
dow, compile in another, link in a 
third and test in a fourth. With OS/2 Crash 
Protection,™ if one application goes down 
due to a bug, the rest youYe working on 
won’t. ' There’s no limit to what you can do 
with this system.... It’s definitely made me 
more productive.” 



The Development Platform of Choice 

* Enhanced development platform for DOS, Windows and 
OS/2 apps. 

* OS/2 Crash Protection for superior reliability. 

* Pre-emptive multitasking for increased productivity. 

* Virtual memory provides up to 512MB per session, 

* Flat memory model eliminates wrestling with segments. 

* Multiple virtual DOS machines for concurrent app 
testing. 

* Object-oriented Workplace Shell is easy and intuitive. 







The object-oriented 
user interface—the Workplace^H— 

Shell™ (WPS)—gives you easy control with 
direct manipulation of visual objects on 
your computer screen. And should you need 
assistance with anything, IBM’s Worldwide 
Developer Assistance Program is always there 
to help. 

“A developer’s dream.” 




PC Magazine Award 
lor Technical Cicettflnca 



OPERATING SYSTEMS AND 
SOFTWARE STAMJARD5 

OS z Version 2 0 


With OS/2s 32-bit architecture, you can 
push your 386 and 486 hardware to the limit, 
and develop spectacular multimedia m 2 

11 -WINNER- 

and enterprise-wide client-server 
applications. OS/2 lets you create 
the widest range of applications, 
for a variety of platforms, for 
almost any size computer. Here’s 
your chance to develop truly 
revolutionary 32-bit applications. With 
OS/2, now there’s nothing stopping you. 

To learn more, call 1 407 982-6408 
now, and get a free white paper on why OS/2 
is the ideal platform for your 
development efforts. 

Operate at a higher level. 




Use OS/2 to increase productivity of DOS, Windows and 
OS/2 application development. 





























Personal Application System 
Builder/2 

Personal AS/2 V3's vendor-indepen¬ 
dent messaging interface allows inte¬ 
gration with office systems, enabling 
files and data to be sent to IBM and 
non-JBM e-mail applications. This 
capability can be extended with the 
optional Personal Application System 
Builder/2 {Builder/ 2). Personal AS/2 
V3's features can also be integrated into 
applications launched directly from the 
Workplace Shell. 

The Personal AS/2 V3 
base product provides 
data access, reporting 
and charting of functions, 
and a graphical procedure 
function for generating 
basic applications. 



Builder/2 functions that help users 

who develop customized solutions for 

others include: 

• A3L, an event-driven develop¬ 
ment language 

• Full SQL access to the OS/2 
client/server database 

• Access to distributed relational 
data via Distributed Data Con¬ 
nection Services/2 (DDCS/2) 

• Support of DDE as client and 
server 

• An interface that allows e-mail 
capability 

• Editors for window layout and 
control placement 

• An intelligent program editor 
for rapid logic creation 

• AC language interface 

• OS/2 clipboard support 

• An interactive debug facility 

• APIs to objects such as Report 
and Chart. 


Source program ; Untitled 

Wake File : OEMOCALC.WTN 

Date : 7-3-92 

Owner : System generated code 

Source window Designated object name 

DEMOCALC.WIN W.DEMOCALC 

ON SELECT 

This block is executed whenever a selectable control or menu 
entry is activated. 


ON SELECT 
DO 

CASE A.System.Object ! Which screen object? 

WHEN "LW.DEMQCALCMultiply 111 1 Menu entry "Multiply" 

DO 

1 Insert your code here 
END 

WHEN W T.W,DEMGCALC.Divide" ! Menu entry "Divide" 

DO 

! Insert your code here 
END 

WHEN "T,W_DEMQCALC.Add ri » Menu entry "Add" 

DO 

! Insert your code here 
END 

WHEN "T,W_DEMOCALC.Subtract" ! Menu entry "Subtract" 

DO 

! Insert your code here 
END 

WHEN "T *W_DEM0CALC.STD,PUSH" 

DO 

CASE A.System.BoxNumber 

WHEN 1 ! Standard pushbutton "Calculate" 

DO 

! Insert your code here 
END 

WHEN 2 \ Standard pushbutton "Clear" 

Figure 2. Example of system-generated ASL code (continued on page 57) 


Builder/2 can be viewed as an such as C It combines customization 
application development tool with a with business tools via its APIs and 
faster learning curve than languages DDE linkages, providing prototyping 
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Figure 2. Example of system-generated ASL code (continued from page 56) 


data at an enterprise, departmental, or 

personal level in several ways: 

* Exploitation of IBM's Distrib¬ 
uted Relational Database Archi¬ 
tecture (DRDA) 

* Support of Information Builders' 
Enterprise Data Access 

(EDA/SQL) technology 

* Links to AS/400 via PC 
Support and DDCS/2 

* The Application System S/390 
Intelligent Server 

* Its own relational-like table 
structures 

* Native ability to read and write 
data formats including ASCII, 
DIF, IXF, and DBF. 
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Figure 3. Personal AS/2 V3 ASL editor 

and application development features 
that can adapt and extend the base 
product to meet specific requirements* 

PROVEN PRODUCT FOR 
MULTINATIONAL BUSINESSES 

Personal AS/2 V3 is the third version 
of the Personal AS product line, first 
introduced in 1989. The product is used 
in a variety of industries—retail, bank¬ 
ing and finance, health, public sector, 
and petrochemical. 

In addition to English, Personal 
AS/2 V3 is available in six languages: 
Dutch, French, German, Italian, Span¬ 
ish, and Japanese (DBCS). This avail¬ 
ability makes it useful for multinational 


businesses seeking a single data analy¬ 
sis product for the enterprise. 

DATA ACCESS: STRENGTHS 

The strength of Personal AS/2 V3 lies 


A decision support component of 
IBM's Information Warehouse frame¬ 
work architecture, the product directly 
accesses data stored in the OS/2 Data¬ 
base Manager or the newer IBM Data¬ 
base 2 OS/2 (DB2/2) product. In con¬ 
junction with IBM's Distributed Data 
Connection Services/2 (DDCS/2), Per¬ 
sonal AS/2 V3 also provides seamless 
access to distributed relational data locat¬ 
ed on remote server databases such as 
OS/400, SQL/DS, and DB2. 

USING BUILDER/2 TO DEVELOP 
32-BIT GUI APPLICATIONS 

Although Personal AS/2 V3 can be 
used as packaged, the most successful 
installations are those in which its func¬ 
tions are launched from a customized 
application developed with Builder/2. 
The custom Presentation Manager GUI 
window shown in Figure 1, for exam¬ 
ple, was created with Builder/2. 

The control of such windows is 


Personal AS/2 V3 provides access to 
relational and nonrelational data at an 
enterprise, departmental, or personal level. 


in its built-in data access; it provides 
access to relational and nonrelational 


managed by Personal AS/2's Applica¬ 
tion System Language (ASL), automati- 
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APPLICATION 

The server application of interest. 

CODE 

An attribute that can be queried to obtain the error code of the last DDE client operation. 

ITEM 

The name of the server item. 

TIMEOUT 

The timeout period, in seconds, beyond which the DDE client object will consider the DDE 


server unresponsive. 

TOPIC 

The server topic of interest. 


Table 1 . Attributes of the ODECLIENT ASL object that can be queried by an ASL application 



DATA 

ERROR 


This event occurs when the ODECLIENT has issued an ADVISE without the immediate parameter, 
and the specified item has been modified. 

This event signifies an error in processing data. 


QUIT This event occurs when the server terminates or no longer services the TOPIC. 

SOURCE(pStream) This event occurs when the DELIVER action is invoked. pSteam is a pointer to a STEAM object 
delivered with the event through which data can be rendered. 

TARGET(pStream) This event occurs when a data delivery happens between a DDESERVER and a DDECLIENT in 
response to either a REQUEST or ADVISE action with the immediate parameter specified. 


Table 2. Discrete events associated with the DDECLIENT ASL client 


• ADVISE(Item, Format, Immediate) may be used to register an interest in a specified item so the client is 
notified whenever the item is updated. 

• DELIVER(Item, Format) allows the client to send data to the server in a format of the client’s choice. 

• EXECUTE (Variable) allows the client to send a command string to the server. 

• PROCESSSMEMORY(pSMemory, Status, Address, Size) is invoked by an instance of SMEMORY when its FINISHEDO 
action is called. 

• QUERYFORMATS(Formats) is used to obtain information about the format capabilities of the server. 

• REQUEST(Item,Format) is used to obtain data from the server on the item specified, in the format specified. 

• SYSTEMdtem, Variable) is used to obtain information about the capabilities of the server. 

• UNADVISEdtem, Format) removes a registration of interest for a prior ADVISE. 

• VERIFYFORMAT(Format) may be used as an alternative to QUERYFORMATS; it verifies that the server can render a 
specific format. 

Table 3. Actions that control the function of the ASL DDECLIENT object 
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Qient/Server 
Database Solutions 


It’s available now—ready to per¬ 
form on your desktop. A new 
function-rich, 32-bit relational 
database you can really trust 
with your growing client/server 
network, your mission-critical 
data and your business. 

Introducing IBM DATABASE 2™ OS/2® 
(DB2/2™) from IBM Programming Systems, the 
birthplace of relational database technology. 

DB2/2 includes an industrial-strength DB 
engine that supports transaction management, 
concurrency control, security, integrity, and 
recovery functions. Designed to exploit the 
power and open architecture of OS/2, it also 
supports industry-standard SQL for developing 
portable applications. And it runs your DOS, 
DOS Windows™ and OS/2 
applications requiring 
online access. 

You can access data 
directly from DB2/2 on 
your desktop or from a 
DB2/2 server on your 
LAN, and with 



DISTRIBUTED DATABASE 
CONNECTION SERVICES/27 
from DB2t SQL/DS7 and OS/400* 
databases as if they were on your desktop, too. 
This versatility can play a significant role in 
an Information Warehouse™ solution 
for your business. 

We’ve developed an 



DB2/2 





exciting demo diskette to show 
you just how well new DB2/2 
performs—right on your desktop. Call us today 
for your free demo, or to order DB2/2: 

1 800 342-6672; or fax: 1 800 445-2426. 

In Canada, call 1 800 465-7999, ext. 850. 

An upgrade from IBM Extended Edition 
or Extended Services is also available. 


'Manufacturer's suggested retail price is $425. 

ISM, OS/2. DB2 and OS/400 are registered trademarks and DATABASE 2, DB2/2. DISTRIBUTED DATABASE CONNECTION SERVICES/2, 
SOL/DS and Information Warehouse are trademarks of International Business Machines Corporation. Windows is a trademark of 
Microsoft Corporation. © 1993 IBM Corp. 









Template for the ON TARGET block. This event is signalled when there 
has been Direct Manipulation between this application and some other 
application. This applications Source window has had an Icon dropped 
onto it from some other application. This application can now ask 
questions to find out what's been dropped, and take action. 


ON TARGETC 
pStream) 

DO 

DECLARE POINTER pStream 
CASE 

WHEN (TpStream)'FORMAT = "Link" 

DO 

DEFINE LinkDataW] 

LET m = BINARY(0,1) 

Figure 4. ASL DDE extentions (continued on page 62} 
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Looking for fast answers 
to your development questions? 


You need to do two things: 

Go on-line with CompuServe 
Information Service. Use Golden 
CommPass to do It. 

CompuServe hosts OS/2 developer 
and user forums monitored by 
technical personnel, IBM devel¬ 
opers are there with responses 
to anything that’s got you 
stuck. Other OS/2 pro¬ 
grammers and enthu¬ 
siasts are there, too, 
comparing notes and 
giving feedback. It's 
definitely the place to be. 



Time is money when you connect to 
CompuServe, and Golden CommPass 
saves you both. It lets you compose 
your questions off-line, send them in 
a flash and disconnect. It gets your 
replies while you re busy program¬ 
ming It's a native OS/2 app, with all 
the power and features you’d expect. 

Get the fastest access to 
answers. Golden CommPass 
keeps your development 
schedule on course. The 
fact is, the sooner you start 
using our program, the sooner 
they’ll be talking about yours! 


Phone: 
(609) 234-1500 

Fax: 

(609) 234-1920 


Golden 

CommDass 





cally generated by Builder/2 when the 
window is created. ASL is an event-dri¬ 
ven object-oriented language. The sys¬ 
tem-generated code that determines 
which window a user has selected is 
shown in Figure 2. 

A key feature of ASL is its combina¬ 
tion of object-based language and event 
handling. It includes a built-in file sys¬ 
tem; vector handling; and mathemati¬ 
cal, string, and graphics facilities, ASL 
is object-based, with objects that can be 
used for tasks from handling complex 
windows to accessing SQL databases, 
DDE, and reporting and charting func¬ 
tions. Execution control is provided by 
a set of discrete events {such as START, 
SELECT, and QUIT) that can be detected by 
the language for specific processing. 

Builder/2 features designed to 
improve programmer productivity 
include a window editor with built-in 
palettes for selecting standard PM con¬ 
trols, a full-function ASL editor, an ASL 
compiler, and a make facility. The editor, 
shown in Figure 3, has been redesigned 
for Personal AS/2 Version 3. 

ASL extensions are provided to sup¬ 
port access to the OS/2 relational data 
manager (DB2/2), DDE, emulator high- 
level language application program¬ 
ming interface (EHLLAP1), and tight 
coupling with C and REXX. 

In Figure 4, ASL extensions for sup¬ 
port of DDE automatically link a Per¬ 
sonal AS/2 application with an OS/2 
2.1 spreadsheet that has been dropped 
onto the application's source window 
for processing, (in this example, Per¬ 
sonal AS/2 V3 functions as a DDE 
client). 

Five attributes of the DDECLIENT ASL 
object can be queried by an ASL appli¬ 
cation; these are shown in Table 1. Five 
discrete events, shown in Table 2, are 
associated with the DDECLIENT ASL client. 
Finally, Table 3 lists nine actions that 
control the function of the ASL DDECLIENT 
object. 

Personal AS/2 V3 can also function 
as a DDE server where a Personal AS/2 
V3 object, such as a report or chart, is 
linked to another OS/2 2,1 object, such 
as a word processing document The 
attributes, discrete events, actions, and 
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Fax/PM uses the advanced OS/2 
features (drag & drop...), turning your 
computer into a sophisticated fax 
machine. 

Fax/PM enables you to send, receive 
and print faxes in background mode. 


OS/2 standalone, LAN or 
.Cj V Client-Server, as well as Windows, 
DOS and AS/400 versions: 
there is a Fax/PM configuration to 
suit your needs. 



Supports Group III fax modems 
(Class 1 & 2). 

All internal laptop modems and 
specific fax boards. 

Standard fax speed (9600 bps) and 
high speed (14400 bps). 



Fax/PM provides APIs for fax 
integration in custom applications. 
These APIs can be called by any 
programming language or 
REXX procedure. 
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Under OS/2: to fax... just print... 
Without leaving your favorite DOS, 
Windows or OS/2 applications, 
Fax/PM makes faxing easy for you. 
All fonts supported, for a 
"Laser-printed" quality fax. 
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PC users. 
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H events for the DDE Server ASL object 
are similar to those listed for the DDE 
Client ASL object, 

PERFORMING EVENTS 
AT SET TIMES 

Buiider/2 "timers" allow events to occur 
at predetermined times or after specific 
time intervals. Timers can be used, for 
example, to schedule a middle-of-the- 
night data manipulation, automatically 
route output to a waiting printer or plot¬ 
ter, or initiate an ASL/EHLLAPI pro¬ 
gram (like the one described in the previ¬ 
ous section) for automated processing 
with the S/390 server. 

Figure 5 shows a sample Personal 
AS/2 V3 timer application developed 
with Builder/2, in which a user can 
specify the date and time a predefined 
Personal AS/2 V3 procedure, report, or 
chart is to be executed. 

These automatically triggered events 
allow users to perform regular tasks 
using the latest corporate data, such as 
producing a weekly sales report or a 
chart of the most active customer 
accounts for a month without human 
intervention. This level of automation is 
made possible by Personal AS/2 V3's 
support for APIs into REPORT and CHART 
objects called from an ASL program. 
Figure 6 shows an API call to the CHART 
object. The type and style of the chart, 
as well as the X and Y data variables to 
be used, can be determined under 
direct ASL program control. 

USING PERSONAL AS/2 V3 IN 
BUSINESS 

Personal AS/2 V3 is designed to access 
enterprise data from the OS/2 desktop; 
its level of integration with the OS/2 
Database Manager, DB2/2 and DRDA 
make it a strong prototyping tool for 
new client/server applications. With 
Builder/2, prototype applications and 
their CUA 91-compliant windows, 
applications can be generated in a frac¬ 
tion of the time required to manually 
code them. In one business application, 
for example, Personal AS/2 V3 is being 
used in joint application development 
projects in which users develop the 



Figure 4. ASL DDE extentions (continued on page 63) 
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Timed Application startup 




I 



Making the Most of your Data Asset 


Click on the gray boxes to change the Time, Date and Object 


Time: 

09:10 


Date: 

22-4-93 


Time & Date to start object 


10:00 A.M. On 22-4-93 


Name of Object to be starter 


D:\DSS\SAMPLES\CHARTSPJ 


r Type of Object - 
Procedure 
Q Report 
® Chart 


Figure 5. Sample Personal AS/2 V3 timer application 


DO 

Several educational offerings on 

STAMP Application 

Personal AS/2 V3 are available 

STAMP Topic 

from Skill Dynamics, an IBM Edu¬ 

STAMP Item 

cation company. For a complete 

SHUT DDECLLent 

list of Personal AS/2 V3 courses 

OPEN DDECLIENT DDEQient, 

available in the U.S., call (800) 426- 

APPLICATION - Application, 

8322 and request a course sched¬ 

TOPIC = Topic, 

ule, or fax (800) 426-4329 and 

TRACE ^ DDETrace 

request the Education List Index. 

LET Text'TEXT = STRING( 


"DDECLIENT QPENed for Application: , Topic: ", 

Disclaimer: This article was prepared 

Application, Topic) 

prior to the general availability of Per¬ 


sonal AS/2 V3 using a development 

CALL DDEQient 'SYSTEM (Sysltems[0], "Syslterns") 

version of the product, Please note that 

LET Request'ENABLED = 0 

some functions could be added, 

LET Advise'ENABLED * 0 

changed, or deleted in the production 

LET Execute'ENABlED = 1 

version of the product. 

END 



Figure 4. ASL DDE extentions {continued from page 62) 
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To use Chart API - CHARTAPI,PGM - ADC 1992 
ON START 
DO 

[Find out *bere Base is installed 
LET BasepatHLControl Path 

ISlpt 

Set the variables that uill be used later 

For OPEN DHCHIRT 
LET ChartType="Bar" 

For SelectTable 

LET filename^Basepath 11 "VSAHPLESXEMPDiITA 11 
LET files)ste(iF ,, PAS" 

For l SetAxisType 
LET xaxistype-'Character" 

For SelDataX 
LET xcolumn=''Division 11 

For Y SetAxisType 
LET ya Kistyp^= ri Nymeric'* 

For SefAnalysis 

LET Column-'AnnualSalary" 

LET Function~ H Avg M 
LET Display-'Abs" 

OPEN IBNCHART Hychart, 

Name = 

Identifier = Basepath||"\Chart", 

Type = ChartType, 

Perspective 3 1, 

Rotated = 1, 

AutoRefresh = 0, 

SavePrompt - 0, 

Dialog = 1, 

EUINode - "Restricted" 

Reset any existing input table 
CALL Hychart'RESETDATA() 


Figure 6. Calling a CHART API from ASL 


!No current name 
! Name of template 
!Chart Type 
!2D = 0, 3D « 1 
!Rotated - 1 or 0 
!AutoRefresh = 1 or 0 
!Prompt = 1 or 0 
!Display dialogs ? 
!Full or Restricted 


Establishing the l and Y data before the input table 
is defined prevents the Select columns dialog from 
appearing automatically. 

Set X axis type, variable set above 
CALL HyChart'5etAxisType( 

"X\ 

xaxistype) 

Set X column, variable set above 
CALL HyChart'SelDataX( 
xcolumn) 

Set Y axis type, variable set above 
CALL Hychart'SetAxisTypeC 
T, 

yaxistype) 

Set analysis for Y scale, variables set above 
CALL HyChart'SelAnalysis( 

Column, 

Function, 

Display) 

Choose the table, variables set above 
CALL HyChart'SelectTable( 
filename, 
filesystem) 

Finally open the Chart 
CALL HyChart'QPENQ 

END 

ON QUIT 
STOP PROGRAM 
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prototype windows themselves using 
Builder/2. 
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Distributed Application/2 (DA/2) can help program client/server or interprocess communication in OS/2 2.0 
or higher. DA/2 provides a simple set of APIs that allows communication between programs running on OS/2 
systems in a network, by ED van vuet, steve wasleski, rick blevins. and andrei malacinski 


Client/Server Programming 
with Distributed Application/2 



(l to r.) Andrei Matorinskt, Steve 
Wasleski, Rick Blevins r and Ed Pam Vliet 


Mm nyone who has written networked 
MM client/server applications knows it is diffi- 
JF ■ cult to choose and use a specific communi¬ 
cation protocol. "Which protocol do I need to code 
and test my application? If 1 
choose protocoi X/' developers 
ask, "will it be available in all the 
networks I support?" 

These and many other questions 
must be answered while designing 
and building a client/server appli¬ 
cation. Once you have chosen a pro¬ 
tocol you must become sufficiently 
proficient to handle most cases that 
arise. Communication protocols can 
be difficult to learn. Most programmers must 
endure a steep learning curve before becoming 


Even after a given protocol is 
mastered, user requirements 
could change the underlying 
communications code. 


munications code of an application. 

DISTRIBUTED APPLICATION/2 

Distributed Application/2 (DA/2) is a layer placed 
above communication protocols that provides a 
simple, consistent way to program interprocess and 
network communication into a client/server appli¬ 
cation under OS/2 2.0 or higher. Figure 1 shows an 
overview of the DA/2 structure. 

DA/2 is designed to hide the complexity of its 
supported communications protocols, allowing 
you to select a communications protocol at run 
time without changing code and to program in 
either C or REXX. DA/2 supports the following 
communication protocols: 

• Auvanced program-to-program 
communication (APPC) 

• NetBIOS for IBM or Novell LAN 
configurations 

• OS/2 named pipes. 

System requirements for DA/2 are OS/2 2.0 or 
later, 1MB of disk space, and 0.5MB of memory 
above OS/2. 

THE FOUR BASIC INTERFACES 

The DA/2 interface is composed of seven APIs. 
Four APIs support data transfer via DAOpen, DtCLose, 
MRead, and DHWrite. The APIs provide a full duplex 
path between the client and the server, adding 
flexibility to program design. These four APIs are 
described in Table 1. 


familiar with the nuances of a given communication 
protocol. Even after a given protocol is mastered, 
user requirements could change the network being 
used, with resulting changes to the underlying com¬ 
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Figure 2 shows a simple conversation between 
a client and server. The client opens the conver¬ 
sation, writes data, then calls OH Re ad to wait for 
data. In Figure 3, the server accepts the conversa¬ 
tion with a call to DAOpen, reads the data sent by 
the client, then writes additional data to the 
client. 

MULTIPLE CLIENT SUPPORT 

Three event APIs, described in Table 2, are available 
to simplify handling multiple conversations. These 
APIs are especially useful within a server applica¬ 
tion that supports several clients concurrently. 

The DAWaitQnEvent API reports either an incoming 
conversation request or an incoming data event to 
the caller, allowing you to specify specific event 
types. For an incoming conversation to be report¬ 
ed, the connection name for the conversation must 
have been identified on a prior call to DAIdentify Re¬ 
source. Events of each type are queued in FIFO 
order, with conversation requests having a higher 
priority than data events. Data events for all con¬ 
versations are reported by DAWaitQnEvent, regardless 
of whether the current process is the initiator or 
acceptor of the conversation. 

A call to DAWaitQnEvent reports the arrival of data 
or a pending conversation; to actually receive the 
data, a DARead call is necessary. To start the pending 
conversation, the ACCEPT option must be chosen in 
the DAQpen API. 

Figure 4 shows a complete REXX server (minus 
error checking) that supports multiple concurrent 
clients. This server can be used with the REXX 
client example in Figure 2. 

ADVANTAGES OF DA/2 


* Single workstation development —Client/ 
server applications can be built and tested 
in a single machine without APPC or Net¬ 
BIOS installed. 

NATIVE APPC APPLICATION 
COMMUNICATION 

In addition to transparently supporting named 
pipes, NetBIOS, and APPC when both partners 
use DA/2, DA/2 provides a method to talk to 
native APPC applications. 



Figure 1 . DA/2 approach to communications programming 


DAOpen 

Makes a connection between two conversation partners 

DAGose 

Terminates a connection 

DARead 

Receives data from a conversation partner 

DAWrite 

Sends data to a conversation partner 


Table 1 . Data movement APIs 


* Ease of use —Each language binding in 
DA/2 was designed to accommodate the 
programming style of that language. 
Option parameters are character strings for 
REXX and UNSIGNED LONG for C. 

• Run-time protocol selection —The application 
is not bound to a specific communication 
protocol when it is built. Rather, the proto¬ 
col is chosen with the DA/2 connection 
profile editor just before the application is 
run. 


You can choose native APPC support by select¬ 
ing either the "Native APPC—Confirmation" or 
"Native APPC—No Confirmation" radio buttons 
on the second APPC page of the Connection Pro¬ 
file Editor notebook. 

Unlike with normal DA/2 support, when using 
the native APPC support it is necessary to be aware 
if a partner is using APPC. In this case, the connec¬ 
tion is no longer full duplex, and some APPC half- 
duplex state considerations arise. 

Considerations are made for APPC confirma¬ 
tion processing by providing an option for DAWrite 
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/* Sample REXX Client 

*/ 

Name - ,r 5AMPLCQN" /* Connection name 


/* Load external functions, load variables into variable pool, 
call nfuncadd 'DALoadFuncs', 'epfdarex', 'DALoadFuncs' 

*/ 

rc = DALoadFuncsO /* load all other DA/2 functions */ 

rc = DALoadVarsO /* load DA/2 return code values 

*/ 

/* Open a connection to the server. 

*/ 

rc = DA0pen(handle. Name, 'DAJMT', "FeedBack") /* Pass in name 

*/ 

/* get back handle 

*/ 

/* Writing data to the server. 

*/ 

Options = 'DA_WRITEJ)ATA' /* initialize options 

*/ 

Respid = 0 /* initialize response id */ 

Buffer = 'This is the data written to server (can be any length)' 

rc = DA Write (handle, Buffer, Options, "Respid", "FeedBack") 

/* Read 100 bytes 

*/ 

rc = DARead(handle, “buff 11 , 100, 'DA.UAIT', “Respid\ "bytesread" 
"data", "conn", FeedBack.) 

9 > 

/* Qose the connection, 
rc = DAGosefhandle, FeedBack.) 

exit 

*/ 


DAIdentifyResource 

Starts queuing incoming conversation requests 


for a specific connection name 

DAWaitOnEvent 

Reports incoming events 

DATerminateftesources 

Discontinues queuing incoming conversation 


requests 


Table 2 Event notification APIs 


and status information for DARead. 

Regular DA/2 and native APPC 
connections can appear in the same 
program. DA/2 event APIs can also be 
used with native APPC support For 
example, the same DAWaitDnEvent call sig¬ 
nals data events from any one of a com¬ 
bination of regular DA/2 and native 
APPC connections. 

SUPPORT FOR THE IMS 
LU 6.1 ADAPTOR FOR 
LU 6.2 APPLICATIONS 

Support for native APPC applications 
also enables a DA/2 client to communi¬ 
cate with an Information Management 
System (IMS) transaction. To invoke 
synchronous IMS transactions, use a 
simple DAOpen, DAWrite, DARead, and DACLose 
sequence. 

To invoke asynchronous IMS trans¬ 
actions, use DADpen, DAWrite, and DAGose, 
The asynchronous reply will return via 
the EISA SYNC transaction program on 
your workstation. You can write the 
IHSASYNC transaction using DA Open, DA Read, 
and DAGose. As before, other regular 
DA/2 and native APPC connections 
can be active in the same program, and 
the DA/2 event APIs can be used. 

THE CONNECTION 
PROFILE EDITOR 

DA/2 keeps run-time connection 
information in connection profiles, 
which are stored in a binary file that 
must be located in a directory listed on 
the DPATi of any system that uses 
DA/2. Profiles can also be shared on a 
LAN drive. 

DA/2 supplies a configuration tool 
called the Connection Profile Editor to 
create and maintain connection profiles. 
This editor, like most, accepts as an 
optional parameter the name of a file 
containing connection profiles. During 
DA/2 installation, a program object is 
created with an association that lets users 
double-click on a *.CP file to start the edi¬ 
tor. The editor is shown in Figure 5. 

The editor uses the CUA 1991 user 
interface architecture, including the 
drag-and-drop technique, to facilitate 
editing and management of the connec¬ 


Figure 2. A sample DA/2 REXX client 


tion profiles. With each setting, you can 
access online help by pressing the FI 
key when focus is on the desired field. 


Once in the editor, you can select a 
profile to edit, double-clicking on it to 
bring up a settings notebook for the 
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/* Sample f^EXX Server */ 

Name = "SAMPLCDN" /* Connection name */ 

/* Load external functions! load variables into variable pool* */ 

call rxfuncadd 'DAloadFuncs*, 'epfdarex', 'DALoadFuncs' 

rc = DALoadFuncsQ h load all other DA/2 functions */ 

rc - DALoadVarsO /* load DA/2 return code values */ 

/* Open a connection to the client. */ 

rc = DAOpenfhandle, Name, 'DA_ACCEPT, "FeedBack") /* Pass name */ 

/* Read data from the client* */ 

Respid = 0 

rc = DA Read (handle, H buff\ 100, 'DA.WAIT, "Respid 11 1 "bytesread”,, 
Figure J, A sample DA/2 REXX server (continued on page 70) 


specified profiles. The first page of the 
settings notebook contains general 
information about the connection, 
including the name of the connection 
and the protocol to be used. Each of the 
notebook pages that follow is devoted 
to information specific to the protocol 
selected* Editor settings are shown in 
Figure 6* 

The second page is used to add 
named pipes and NetBIOS connection 
information and to specify whether the 
server is queued or nonqueued* If 
"nonqueued" is selected, a new server 
is started each time a connection is 
opened. If you select "queued/" the 
connection Is made to an already run¬ 
ning server; in this case, a new server is 
started only if a queued server is not 
already running. 

The third and fourth notebook 



How are you going to test your client/server apps? 
Check one: 

_| Manually 

_| Partially 

I-1 The Softbridge 

_I Automated Test Facility 


It’s not a trick question, but testing client/ 
server applications can be a tricky business. 
Traditional, manual methods can't stand up to 
the complexities of client/server. And most 
automated testing tools provide only a partial 
answer — concentrating on the GUI desktop, 
and leaving the rest of the client/server testing 
puzzle for you to piece together. 


Only the Softbridge Automated Test Facility 
(ATF) is designed to cover all aspects of 
client/server testing — GUI, distributed 
systems, legacy applications. If you’re doing 
client/server development, maybe it's time 
you checked out ATF. To find out how ATF 
can help with your client/server testing needs, 
call 1-800-955-9190. 

Softbridge, Inc. 
125 CambridgePark Dr. 
Cambridge, MA 02140 
617-576-2257 (Phone) 
617-864-7747 (FAX) 


The Softbridge 

® Automated Test Facility 
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pages are devoted to APPC-speeific 
information. This includes configura¬ 
tion information for APPC, such as the 
remote transaction program name, 
mode name, local logical unit (LU) 
name, partner LU name, and other pro¬ 
file information specific to an APPC 
connection such as data conversion and 
whether your partner is using DA/2 
APIs or native APPC. 

With the Connection Profile Editor, 
you can manage multiple connection 
profiles using drag-and-drop. An 
administrator may want to maintain a 
master file of connection profiles to dis¬ 
tribute as needed. 


"data", "conn", FeedBae.) 


f* Writing data to the client. 

*/ 

Options * 'DAJRITEJDATA' 

Buffer s "This is data to write to the Client/ 


Respid - 0 

rc - DAWriteOiandle, Buffer, Options, "Respid", "FeedBack") 


ft Qose the connection. 

*/ 

rc = DAdose(handle, FeedBack.) 
exit 


Figure 3. A sample DA/2 REXX server (continued from page 69) 


/* REH Server supporting multiple clients sample. */ 

Name - "SAHPLCON" /* Connection name */ 

ft Load external functions, load variables into variable pool, */ 
call rxfuncadd 'DALoadFuncs', 'epfdarex*, 'PALoadFuncs' 
re s DILoadFuncsO /* load all other DA/2 functions tj 

rc - DALoadVarsO /* load DA/2 return code values */ 

rc = DAIdentifyResourcef Name, "FeedBack"); 

do FOREVER 

rc - DAUaitOnEventC "outName"* "outHandle", 'DA_ALL_EVENTS', "eventType", , 
"dataLength", 11 responselD", "FeedBack"); 

if rc = 0 then 
do 

if eventType = 'DA^CQNNECTIOfT then /* open the incoming conversation tf 
do 

rc = DADpenC 1 handle"* out Name, 'DA_ACCEPT # , 11 FeedBack 11 ); 
end 

else if eventType = # DA_DATA* then /* handle the incoming data event */ 
do 

responselD = 0 

rc = DARead(outHandle, "buff, dataLength, 'DA.WAIT', "responselD", , 
"bytesRead", "dataStatus", "connStatus", "FeedBack"); 
if connStatus = # DA.CLOSE' 1 then 
do 

rc - DAdose(outHandle, "FeedBack"); 
end 

else do 

/* ...process the data just read and send back a reply *f 
rc = DAWritefoutHandle, buff, 'DA.WRTTE.DATA', "responselD", , 
"FeedBack"); 

end 

end /* end if eventType = 'DA_DATA* */ 
end /* end if rc - 0 */ 
end /* end do FOREVER loop */ 


Figure 4 L Multiple client server 
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CONCLUSION 

DA/2 provides the communications 
needed for writing client/server appli¬ 
cations in most OS/2 environments. 
Full duplex paths are provided for 
APPC, IBM and Novell NetBIOS, and 
OS/2 named pipes. 
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Figure 5. Connection profile editor, common information 


Andrei Malacinski, IBM Programming 
Systems. P.0. Box 60000, Cary, N.C. 27512. 
Malacinski is an associate programmer 
with IBM Application Platform Products, 
currently working as a member of the DA/2 
team. He was responsible for the design 
and implementation of the DA/2 REXX pro¬ 
gramming interface and user interface of 
the DA/2 connection profile editor. 
Malacinski joined IBM in 1990 after receiv¬ 
ing degrees in mathematics and computer 
science from Indiana University. 

Ed Van Vliet, IBM Programming Systems, 
P.0. Box 60000, Cary, N.C. 27512. Van Vliet 
is an advisory programmer with IBM Appli¬ 
cation Platform Products and currently the 
project leader for the DA/2 team. During 
his IBM career, Van Vliet has held archi¬ 
tectural and project leadership positions for 
large systems and workstation communi¬ 
cations projects. 

Steve Wasleski, IBM Programming Sys¬ 
tems, P.0. Box 60000, Cary, N.C. 27512. 
Wasleski joined IBM in 1987 and is cur¬ 
rently on the DA/2 development team. His 
responsibilities include development and 
support of DA/2. In his six years with IBM, 
his work has included client/server com¬ 
puting, GUIs, and communications. He 
holds a B.S. in computer science from the 
University of Missouri. Rolla. 



Figure 6. Connection profile editor settings 
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Client/Server 



/4s client/server computing becomes widely used, corporations and developers must handle their client/server 
needs. This article explains Easel Workbench and explores its advantages for corporate developers. 

BY CHRIS BROOKINS 


Easel Workbench: Robust 
Client / Server Development 


C lient/server computing has been emerg¬ 
ing in the computer industry for the last 
several years, but it is only in the past year 
or so that the idea of client/server has caught on 
within the ranks of corporate developers. Informa¬ 
tion systems organizations see client/server as 
their way of exploiting the computing power and 
information resources of their enterprise. But 
increasing application needs, combined with 
steadily more complex computing environments, 
has led to a bewildering array of implementation 
options associated with client/server. 


CLIENT/SERVER FRAMEWORK 


Defining Client/Server Client/server technology is 
a form of computing that divides application func¬ 
tion among networked computing resources, some 
of which are PCs or workstations commonly hav¬ 
ing a graphical interface. Within this definition 
there exist five forms or models of client/server 
computing, shown in Figure 1: 

* Database-server 

* Transaction-server 

* Peer-distributed 

* Presentation-distributed 

* Presentation and logic 

Database Server . For applications that need to access 
data from a variety of back-end data sources, there 
is the database-server model of client/sewer. In this 
model, SQL is simply embedded in the client appli¬ 
cation and sent to the database server for process¬ 


ing. Since the interface between the client and the 
serv er is strictly SQL-based, processing on the server 
is limited to what SQL can perform. Often, results 
are returned and processed further at the client. 


Transaction Server. Applications such as order entry, 
process control, and other mission-critical online 
transaction processing applications require consis¬ 
tent, minimal response times. The transaction- 
server model is optimal for OLTP requirements 
because it allows processing to be distributed and 
balanced between the client and the sewer. Data- 
intensive operations can take place at the sewer 
while user intensive tasks can be handled at the 
client. In addition, this model eliminates unneces¬ 
sary network traffic, since only the request and the 
final result are sent between client and server. 
Data processing that can't be accomplished with 
SQL, such as conditional logic or complex aggre¬ 
gate functions, is performed on the server, elimi¬ 
nating the need for data to be sent over the net¬ 
work for client processing. 

A transaction is a single logical unit of work 
that may be as simple as an SQL statement or as 
complex as a combination of SQL statements, pro¬ 
cessing logic, and non-SQL data manipulation. 
The client initiates transactions such as UpdateSys- 
temBaLances by name, hiding the underlying com¬ 
plexity from client developers and allowing trans¬ 
actions to be maintained independently of client 
applications. 



Chris Brookins 


Peer . The peer model contains all the benefits of the 
transaction-server model with the added flexibility 
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that at any time the client and server 
can switch roles. This model is useful 
when an application must respond to 
unforeseen external events. For exam¬ 
ple, in a process monitoring system, a 
stockbroker application can request 
stock price information from the host 
server or the host server can send unso¬ 
licited data to the desktop if the stock 
price reaches a specified threshold. 

Distributed Presentation And Logic. Existing 
host-based legacy systems have become 
easier to use with the advent of PC- 
based graphical user interfaces, which 
brought about this form of client/server 
computing. The pure distributed pre¬ 
sentation model can improve usability 
by simply remapping existing host 



screens into equivalent graphical inter¬ 
faces with pulldown menus, entry 
fields, and other dialogue controls. 
Host-based applications in which codes 
must he entered, selection lists are not 
available, or the screens are difficult to 
understand become more user-friendly. 
It is possible to transform existing 
host-based systems into new systems 
that leverage the PCs power by adopt¬ 
ing the distributed presentation and 
logic model. In this model, a new sys¬ 
tem is developed that utilizes existing 
services presented by the host system. 
Processing logic at the PC can off-load 
host processing or introduce complete¬ 
ly new functionality such as image, 
sound, or voice. This approach borrows 
from the database server model in that 
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the host application is fixed and prede¬ 
fined, although here the interface is 
through an existing path of host screen- 
to-screen navigation. Since application 
logic is split and executed between the 
server and the client, this model also 
contains some benefits of the transac¬ 
tion-server model, shown in Figure 2. 

Hybrid Applications* Corporate data infra¬ 
structures do not change overnight, nor 
do existing systems. A hybrid approach 
allows a developer to combine more 
than one client/server model in an 
application to meet the real needs of a 
business. For example, the goal may be 
to move the entire system to a Database 
Manager-based solution over time, but 
it is too time-consuming and expensive 
to reengineer everything at once. A 
hybrid application in this case would 
communicate with the existing system 
through distributed presentation sup¬ 
port, as well as add new application 
components on the LAN that are 
accessed through transaction server 
support. 

EASEL WORKBENCH AND 
CLIENT/SERVER DEVELOPMENT 

Easel Workbench was designed to help 
application developers best use the 
power of client/server computing. 
Workbench includes an integrated, 32- 
bit, OS/2-based development environ¬ 
ment, the event-driven EASEL lan¬ 
guage, an extensive variety of connec¬ 
tivity options, and a production system 
for the target user platform (OS/2, 
Windows, or DOS). Because the Work¬ 
bench supports a powerful client/sew¬ 
er framework, its connectivity options 
can integrate data from nearly any 
source. 

Support for the Database-Server Model. For 

applications that need to access data 
from a wide variety of back-end data 
sources. Workbench provides support 
for the database-server model of 
client/sewer. Like all Easel client/sew¬ 
er support, database processing occurs 
entirely on a separate thread, allowing 
the Easel client application to continue 
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operation. When results are returned, an 
Easel event, or ''response/' is triggered. 
Database server results can be retrieved 
record by record, or written directly to a 
local file for bulk processing. 

Easel provides direct database server 
support for IBM's Database Manager, 
the Oracle Server, Microsoft/Sybase 
SQL Server, and all databases support¬ 
ed by IBI's EDA/SQL support. Easel's 
support for the Database Manager is 
DRDA-compliant; where DDCS/2 is 
installed, applications can communicate 
transparently with all SAA databases 
including DB2, SQL/400, and SQL/DS. 
To insulate developers from the com¬ 
plexity of each unique database API, all 
Easel database drivers provide a high- 
level common programming interface, 
which lets a programmer change the 
back-end database without changing a 
client application. Multiple connections 
to the same or different database 
servers can also exist simultaneously, 
allowing the integration of information 
from multiple sources. 

Support for the Transaction-Server Model. 

Easel provides transaction server sup¬ 
port with three main technologies: 
stored procedures, CICS-OS/2, and the 
Easel Transaction Server (ETS) Toolkit, 
shown in Figure 3. 

Stored procedures are transactions 
containing compiled SQL and process¬ 
ing logic stored within the database 
server. For database servers that sup¬ 
port stored procedures such as 
Microsoft/Sybase and Oracle SQL 
Server, Easel applications can initiate a 
procedure on a separate thread. When 
the procedure has completed process¬ 
ing, the application is notified by way 
of an Easel event 

Easel provides a high-level interface 
to CICS-OS/2 that makes it easy for an 
application to initiate transactions 
residing on CICS-OS/2 workstations or 
hosts. CICS transactions can be initiat¬ 
ed with a simple subroutine call to 
CICS's Extended Call Interface, includ¬ 
ing a transaction name and an input 
and output structure. The request is 
processed on a separate thread and the 


application is notified upon comple¬ 
tion, At that time, the output structure 
is populated with any data returned 
from the database. 

Easel Workbench includes the ETS 
Toolkit, which allows developers to 
create and access OS/2-based transac¬ 
tions with a remote procedure call 
mechanism for all SAA databases 


(Database Manager, DB2, SQL/400, 
and SQL/DS). ETS transactions, based 
on the Database Manager's application 
remote interface, are written by creat¬ 
ing procedures of SQL and processing 
logic within an ETS C or COBOL tem¬ 
plate. Easel applications can initiate a 
server transaction with the ETSExecute 
subroutine. The request is delivered to 
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Figures. The ETS Toolkit 



Figure 4. Integrated development environment 
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EVENT TYPES AND RESPONSES 



Event Types 

User initiated events 

Communications/ 
external events 

Time events 

Special EASEL events 

Table i. Easel event types and responses 


Example 

User selected a button 
named OK 

An ETS transaction has completed 
response to stimulus 

5 seconds have elapsed 

EASEL application has started 


Example EASEL (ode 

response to OK 

ETS_DONE 

response to interval 5 
response to start 


USING ACTION STATEMENTS 

Modify/query object attributes 
Create or delete objects 

Call other EASEL subroutines or subroutines within a DLL 
Control program flow: for loops, while loops, if/then/else 
Perform string processing or integer and floating point arithmetic 
Read and write text, image, or structured data to and from disk 


EXTERNAL LIBRARIES PROVIDED WITH WORKBENCH 

Local PC Processing 

DDE, File I/O 

Communications 

APPC, C1CS OS/2, 3270/5250, VT-100 

Database Access 

DB Manager (DB2, SQL/DS, SQL/400 
via DRDA), Sybase/Microsoft SQL Server, 
Oracle, and EDA/SQL (optional) 

Miscellaneous 

Math Functions, Date Functions, 

Help Manager Functions 


Table 1 External libraries provided with Workbench 


the OS/2 server on a separate thread, 
with NetBIOS on OS/2 Extended Ser¬ 
vices or the APPC SQLOO protocol with 
Remote Data Services. The server pro¬ 
cedure can execute directly against the 
Database Manager or, if DDCS/2 is 
installed, can connect to DB2, SQL/400, 
or SQL/DS. 

Support for the Peer Model. Easel pro¬ 
vides peer support for developers with 
the APPC protocol. To provide the 
most control while shielding complexi¬ 
ty, there are two APPC interfaces, auto¬ 
matic and controlled. The automatic 
interface takes care of the necessary 
acknowledgments and implicitly 
switches conversation states from send 
to receive without forcing developers 
to perform subroutine calls. For more 
complex applications, the controlled 
interface gives developers complete 
control over the details of the APPC 
conversation, 

APPC events appear like all other 
Easel events—as uniquely identifiable 
external responses. Like all other 
client/server support, APPC messag¬ 
ing and communications occur on a 
separate thread, allowing the applica¬ 
tion to continue running during peer 
processing. 

Support for the Distributed-Presentation 
Model . Easel supports the distributed- 
presentation models with high-level 
support for HLLAPI, VT-100, and asyn¬ 


Table 2. Ways to use Easel action statements 


chronous communications that mask the 
complexity of the underlying API. For 
example, applications are notified of 
incoming asynchronous data from Com¬ 
puServe through Easel responses. 

Through the HLLAPI provided by 
most PC emulators. Easel applications 
can access 3270 and 5250 applications. 


Easel can also access applications on 
various platforms through other proto¬ 
cols, with Software Corporation of 
America's TalkThru emulator. The 
functions available from HLLAPI sup¬ 
port include: 

* To retrieve host data: ReadField, Get* * 
FieldAttribute, ReadScreen, ReadLine, 
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Figure 5. The parts catalogue 


* To write data to host: VriteField, 
PressKey, EnterString. 

* For host synchronization: Watch- 
ForStringAt, VatchForCustorAt. 

* Other: EmulateAndVatch, GetSessionSta¬ 
tus, SetEmulatoryindow. 

Support for Hybrid Applications. A single 
graphical interface can implement any 
number of client/server models that 
access data throughout an enterprise. 
Through its support for multiple mod¬ 
els, a single Easel application can 
update diverse systems with the same 
data. Many companies use Easel appli¬ 
cations to transparently keep multiple 
systems in sync. 

THE EASEL LANGUAGE 

The EASEL language is a high-level, 
event-driven language designed for 
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VISUAL EDITORS 


Layout Editor 

Builds all windows and dialogue controls 
using the tool palette and various alignment 
facilities 

Menu Editor 

Defines CUA menus including accelerators 
and mnemonics 

Attribute Editor 

Specifies all object attributes such as color 
and visibility 

Drawing Editor 

Creates custom vector graphics using the 
line, box, ellipse, arc and shape tools in con 
junction with zoom and alignment facilities 


Table 4 L fase/ Workbench tools for all phases of the development cycle 



Figure 6 : Workbench debugging facilities 


developing applications with a graphi¬ 
cal interface for all client/server mod¬ 
els. Easel applications can run under 
OS/2, Windows and DOS. Under OS/2 
2.0, they use the 32-bit architecture and 
graphics engine. 

EASEL shields developers from the 
complexities of (and differences 
between} the underlying operating 
platform and connectivity APIs. Its 
complete set of programming con¬ 
structs provides facilities for develop¬ 
ing and controlling an application's 
graphical interface, communications, 
database access, and processing logic. 

EASEL Objects. At the core of the EASEL 
language are objects that correspond to 
other objects with visual attributes. These 
objects include familiar OS/2 and Win¬ 
dows dialogue boxes and controls, as 
well as special Easel objects such as 
image regions {windows that hold 
bitmap images) and graphical regions 
(windows that hold scalable vector 
graphics). All objects have attributes such 
as visibility, color, and size that can be 
queried and changed at runtime. Objects 
can be created either visually in Easel 
Workbench or dynamically, based on 
data received during runtime. Objects 
can also be grouped into classes to which 
a single action can be performed (such as 
making them ail invisible). 

Event-Driven Programming. Easel's non¬ 
procedural, event-driven nature allows 
developers to quickly prototype and 
incrementally add new functionality as 
needed. To respond to user and system 
activities, developers write responses to 
events of the types shown in Table L 

Robust Language Constructs . Within a 

response, developers can choose from 
a set of action statements that control 
application behavior. Table 2 lists ways 
to use these actions. 

Extensible. Developers can also access 
routines in external libraries or modules. 
Easel provides a complete set of 
libraries, but developers can create their 
own. Table 3 lists some of the external 
libraries provided with Workbench. 


IMPLEMENTING WITH 
EASEL WORKBENCH 

EASEL, along with support for its 
client/server models, is the foundation 
for the Workbench, a 32-bit, 03/2- 
based integrated development environ¬ 
ment in which developers can visually 
define a user interface, add application 
logic, and test and debug Easel applica¬ 
tions. This environment is shown in 
Figure 4. 

Parts Catalogue . Central to the Work¬ 


bench is the parts catalogue {shown in 
Figure 5), which allows developers to 
browse, edit, and create the compo¬ 
nents of an application with a listing of 
project views, or modules, and a hierar¬ 
chical presentation of application parts. 
Selecting a part loads and launches the 
associated editor. Double-clicking on 
any part, for example, launches the 
appropriate visual editor for quick 
modifications. All modifications are 
incorporated into the application by an 
incremental compiler that speeds up 
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the development cycle. The parts cata¬ 
logue also displays project views, 
which are stored in ASCII files that pro¬ 
vide simple integration with version 
control systems. 

Visual Editors * Workbench's visual edi¬ 
tors allow you to define the interface in 
a WYSIWYG environment. CUA moni¬ 
toring can check an interface against 
Common User Access rules of interface 
design. The visual editors are listed in 
Table 4. 

Debugging Facilities. Application logic is 
added with Easel's integrated text edi¬ 
tor. Debugging facilities, shown in Fig¬ 
ure 6, include: 

* Source-Level Debugger . This facility 
displays executing source code. 


Developers can visually step 
through statement-by-statement or 
by Individual procedure, set break¬ 
points, and change runtime values. 

* Trace Windows. This facility displays 
a detailed record of an application's 
execution. Developers may open 
several trace windows and set filters 
to customize the type of information 
monitored in each window* 

* Stack Window. This facility displays 
the level of nesting that occurs dur¬ 
ing program execution. Developers 
may inspect and change variables 
on the stack. 

Example. The insurance representative 
workstation shown in Figure 7 inte¬ 
grates data from two client/server 


models and makes extensive use of 
images* When compiled for OS/2, the 
application automatically exploits the 
32-bit API. 



The work of this application was 
formerly a paper-based process in 
which a representative entered 
appraisal forms into an aging host- 
based system. The organization want¬ 
ed to transfer part of the system to 
Database Manager and reengineer the 
entire process with PC and imaging 
technology. 

The Easel system developed to 
address this problem controls an image 
bank on a minicomputer, which 
responds to the clerk pushing a button 
by issuing commands to download the 
next scanned appraisal form and item 
photograph in the processing queue. 
After reviewing the form in a window, 
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Do you need uniform access to dBASE files from your 
custom DOS, Windows, and OS/2 applications? 

Introducing dbfLIB, the dBASE file access library for 
DOS, Windows, and OS/2 programmers. 


Features: 

* A single set of functions for DOS, Windows, OS/2 l .3, OS/2 2.0 

* Royalty free Dynamic Link Libraries for: 

- Windows 3.0 and Windows 3J 

- OS/2 1*3 06-bit DLL) 

* OS/2 2*0 (32-bit DLL) 

* Static libraries for DOS and OS/2 applications, 

* Meaningful fimetion names familiar to the xBASE programmer. 

* File and record locking. 

* Handle-based calls allows multiple instances of the same dbf file 

(very useful in multi-threaded OS/2 programs). 

* Create, update, and index dBASE files. 


dbfLIB includes Windows DLL, OS/2 1,3 DLL, OS/2 2.0 DLL, and 
static libraries for DOS and OS/2. 


dSOFT Development Inc. 
4710 Jnnsbnjk Drive 
Houston. IX 77066 
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Automatic branching. Automatic version labeling across branches. 
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whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 


* Plus the features they loved in TLIB 4: 

Check-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon CRs in the file like other 
products)* Wildcard and fist-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
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Business Software 
Solutions 


CONFERENCE & EXHIBITION 


Our New Good looks 
Are Nice, But it’s What’s 
inside That Counts. 


The software industry is changing. 
Businesses are rightsizing, new GUI plat¬ 
forms are in the news, and software and 
operating platforms are becoming ever 
more important variables in todays busi¬ 
ness computing equation. 

You have a lot to keep up with today. 
So, were retooling two great industry 
events to help you do just that. 

Windows & OS/2 
BECOMES BUSINESS 
Software Solutions 

First, Windows & OS/2 has changed its 
name to Business Software Solutions. 
Why? To let you know were keeping up 


with your growing need to bring 
cost effective GUI-based solutions to 
your business. 

At Business Software Solutions you'll 
get the best of the old Windows & OS/2 



Conference. You’ll still find the hottest 
software for todays key GUI-based plat¬ 
forms. You’ll find test drive centers where 
you can try out apps before you buy. And 
you’ll find many of the biggest name 
industry gurus telling you like it is about 


what’s hot and what’s not. 

But we’ve added so much more, you’ll 
barely recognize the place! 

First, we've rebuilt the conference 
program from the ground up to provide 
you with much more value. Whether you 
manage your own business, or work for 
one of the Fortune 500, you'll find the 
answers you need about today s GUI- 
based platforms and software. 

You’ll discover how to make sound 
buying decisions that insure your invest¬ 
ment as technology changes. You'll learn 
whether or not its a must to settle on just 
one platform for your business. You'll 


















learn how to set up and manage multiple 
platforms over a network. 

Then, youll find how to use the most 
cost-effective training tools and techniques 
to support and train your end-users. You'll 
discover how to give your enterprise easy 
access to legacy data on the desktop. And 
youll learn how to build Windows and 
OS/2 solutions that meet the real needs of 
your end users. 

On top of that, we’ve added a 
Solutions Interchange Room where you 
an trade ideas with peers, a Solutions 
Theatre for head-to-head vendor demos, 
and much more! 

All in all, youll find the whole event 
focused on how to help you solve your 
biggest end-user computing problems 
using the best of todays desktop technolo¬ 
gy PLUS youll get a glimpse into whats 
coming next after Windows and OS/2, 

Software Development 
y 93 Joins Business 
Software Solutions 

Take the newly refocused Business 
Software Solutions Conference and add 
the largest and most respected technical 
conference and show for anyone involved 
in building desktop or client-server appli¬ 
cations, What have you got? A dynamic 
industry event that reflects the entire desk¬ 
top software process from development to 
final applications and solutions! 

SD has long been seen as the best 
place to get unbiased heres-how informa¬ 
tion on developing for the desktop. With 


over 150 courses in tracks ranging from 
Windows, OS/2 and UNIX development, 
to Analysis & Design, C++, Client-Server 
development, User Interface Design and 
Management, youll have a hard time 
choosing which sessions to attend 
And, again, thats not all. On the 
show floor youll see the best available 


development products from leading tools 
vendors. SD was the site of Borland’s 
launch of Borland C++ last year, and 
Microsoft s Visual C++ and 40 other 
new products this 
February, This August 
youll find more of the 
hottest tools on the 
market And, youll get 
an extra bonus. That s 
because your SD ticket 
also gets you into 
Business Software 
Solutions, the software 
solutions showcase of 
die summer. 


WE CHANGED OUR 
LOOKS TO GET YOUR 
ATTENTION... 

But we know that its whats inside that 
counts. And whether you re interested in 
the solutions side or the development side 
of the desktop software equation, at 
Software Development and Business 
Software Solutions youll find answers to 
more of your business software questions 
than ever before in two quality confer¬ 
ences and more than 250 exhibits. 

To get detailed information on what 
youll find when you arrive, return this 


coupon, phone us at 415-905-2784 or fax 
us at 905-8100 today. Well send you a 
complete conference catalog, and a ticket 
fora free show pass. 


Yes! Tell me More! 


Please send me more information about your 
two conferences & exhibitions being held 
concurrently in Boston, August 23-27, 1993, 

O Business Software Solutions 
□ Software Development 


Miller Freeman, Inc ♦ 

OOO Harrison Street * Sent Francisco* CA 9* 107 
415-905-2784 • FAX *15-905-8100 


OS2D 



Come see for yourself. August 23-27 in 

BOSTON AT THE HYNES CONVENTION CENTER. 






















the clerk enters the first few letters of 
the owner's last name into a dialogue 
that invokes an ET3 transaction against 
the Database Manager to present a list 
of matching names. When the clerk 
selects a name, the system issues a 
transaction that returns the owner's 
complete profile, including a list of 
appraised items. The clerk then adds 
the item by entering information into 
the dialogue box, and Easel updates the 
existing host-based system through the 
distributed presentation and logic 
model. With other transactions, it 
updates the database with the new 
insurance premium. Finally, the clerk 
can send a form letter by pressing the 
Correspondence button {which initiates 
Microsoft Word, loads a form, and 
enters the owner's name and updated 
list of appraised items via DDE). 

Chris Brookins, Easel Corp. f 25 Corporate 
Drive, Burlington, Mass. 01803. Brookins is a 
product manager at Easel. He has been actively 
involved with the EASEL language and Easel 
Workbench for three years. Prior to joining 
Easel, Brookins was a manager of systems plan¬ 
ning at General Electric: He holds a B.S[ in com¬ 
puter science from Lehigh University. 




Figure 7. Clerks insurance workstation application 
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The ICSS Speech Recognition API helps programmers develop applications that recognize and process a contin¬ 
uous flow of spoken English words. This article explores the main functions and features of the ICSS software 
and provides a programming example, by vincent Stanford and brandon booth 


Speech-Enabling Your 
Applications With ICSS 

V he ICSS Developer's Program consists of 
m prerelease software currently being system- 
■ tested by IBM. It is fully supported for pro¬ 
gram members; members give opinions, report 
bugs, and submit design change requests, which 
leads to improvements in process and product. 

The ICSS Speech Recognition API, currently 
being tested under the program, helps program¬ 
mers develop applications that recognize and 
process a continuous flow of spoken English words. 

ICSS PRODUCT FEATURES 

Speaker Independence. Though there are variations 
in human speech from person to person, unlike 
other speech recognition systems ICSS requires no 
speaker enrollment or user training. iCSS has been 
tested with a variety of accents and under high 
background noise conditions. Though perfor¬ 
mance varies, good recognition is possible in spite 
of a variety of accents and background conditions. 

Continuous Speech. Users can speak at natural or 
rapid rates with successful recognition. This is 
important for command and transaction applica¬ 
tions that require high-speed control of user inter¬ 
faces as well as for high-speed data entry by those 
who find keyboards difficult or uncomfortable to 
use. 

Large Vocabulary. ICSS provides recognition under 
multiple switchable contexts of up to 1,000 words 
each. With the context-switching feature, pre- 
loaded multiple contexts can extend the practical 


reach of the system to complex real-world applica¬ 
tions. The base dictionary contains over 20,000 
words; users can add words without gathering 
additional speech samples or retraining the system. 

Client/Server Metaphor. The recognition server can 
support multiple applications running on the 
same machine. The recognition engine serves as a 
serially reusable resource for a desktop of appli¬ 
cations. 


Unlike other speech recognition 
systems, ICSS requires no speaker 
enrollment or user training. 


Grammar-Guided Recognition. ICSS is designed to lis¬ 
ten for and process specific sets of words and 
phrases based on predefined grammars. Its recog¬ 
nition engine uses context-related language mod¬ 
els to guide the search process that decodes text 
from speech. These language models can be 
bigrams (word-to-word transition pairs and prob¬ 
abilities) or finite state grammars. The models can 
be derived from either Backus-Naur form (BNF) 
grammars or example texts. 

Additional Product Information. ICSS provides devel¬ 
opment and run-time support for speech recogni- 
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tion-capable applications in the OS/2 
and AIX environments. For many 
tasks, recognition is performed at or 
near real time on contemporary 80486 
processors with five additional 
megabytes of main memory above that 
required for other purposes. Because it 
takes advantage of OS/2 2.1's preemp¬ 
tive multitasking, ICSS begins to 
process speech data before the speaker 
finishes talking, increasing response 
time. 

What Kinds of Applications Can 
UseICSS? 

ICSS can be applied to situations in 
which user productivity, space, or hand 
motion is at a premium. It is best suited 
for applications that have clearly 
defined sets of actions or data entry 
requirements that can be addressed by 
large vocabulary-continuous speech 
recognition. Users must be familiar with 
the command structure of their applica¬ 


tions, but more freeform applications 
can be supported for limited domains. 

Users adapt to speech recognition 
quickly, and recognition rates improve 
as speakers use the system. The contin¬ 
uous speech mode supported by ICSS 
lets developers support high-speed 
multifield data entry (using a connect¬ 
ed utterance). Situations that are well 
suited for ICSS voice-enabled applica¬ 
tions include: 

• Processing transactions using 
GUI-based applications 

• Executing hands-free data entry 
so an operator can simultane¬ 
ously handle and catalogue an 
object 

• Retrieving data from informa¬ 
tion systems such as SQL data¬ 
bases 

• Supporting help desk opera¬ 
tions 

• Controlling simulators 


• Controlling instruments 

• Navigating through user inter¬ 
faces 

• Data entry. 

HOW DOES ICSS WORK? 

The logical architecture of ICSS is 
depicted in Figure 1, which shows the 
major system components that make up 
the development and run-time systems. 

Analog to Digital Conversion. This compo¬ 
nent currently consists of an IBM audio 
capture-and-playback adapter (ACPA) 
card and its associated software driver. 
The adapter is available in Micro Chan¬ 
nel (MCA) and IBM AT Bus architec¬ 
tures. ICSS supports data acquisition 
using the ACPA at rates of 11 KHz and 
22KHz in linear 16-bit PCM samples. Of 
the two rates, 22KHz provides the high¬ 
er accuracy but is computationally more 
demanding. 11 KHz is adequate for 
most, if not all, applications. 
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<inain_win_cmd> :: “ FILE 

lEoir 

I VIEW | 

TEXT 

1 STYLE 

1 PAGE | 

FRAME 

1 TOOLS 

I WINDOW | 

HELP 

I PAGE-UP 

I PAGE-DOWN . 


Figure 2, "Window dressing" context supporting a command structure 

<pin> ::= <digit> <digit> <digit> <digit> * 

<digit> ;:*= ZERO I OH | ONE I TWO I ... 1 NINE . 

Figure 3. Setting up the BNF form o f a PIN context 


step significantly compresses the 
speech data. 

Recognition Search. After data has been 
vector-quantized, the feature vectors, 
context word-pair grammars, and 
acoustic phoneme models are used by 
the recognition engine for actual recog¬ 
nition of the speech signal. This is done 
with Hidden Markov models for pat¬ 
tern matching of the acoustic data 
stream. 



Speech Recognition API The speech 
recognition API lets recognition clients 
communicate with the ICSS recognition 
engine. This allows several features: 


Data Conditioning and Rate Conversion. 

This step converts speech data from 
external to internal formats for use dur¬ 
ing the feature extraction phase of the 
recognition process. 


Vector Quantization. Once the speech 
data samples have been converted to 
the appropriate format, the feature 
extraction phase of the recognition 
process begins. The feature extraction 


* Context-loading 

* Context-switching 

* Control of data acquisition 

* Return of text decoded from 
speech 

* Control of various runtime 
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Initializes the ICSS API code and data and prepares to start communications with the ICSS 
server. 

Establishes communications with the requested ICSS server facility. 

Requests the ICSS server to load a context into memory in preparation for guiding the ICSS 
listening process. 

Retrieves the setting of a specified ICSS control variable so the application program can 
verify the setting. 

Sets the value of a specified ICSS control variable so the application can customize ICSS to 
its requirements. 

Causes ICSS to begin listening to the specified source for speech. Once listening has started, 
ICSS returns control to the application program. 

Causes the ICSS server to retrieve the text representing the recognized speech, in order to 
return it to the application program. This text is not returned until the listening and 
recognition process is complete. 

Causes the ICSS server to play a specified digitized audio file on a specified output device. 
The application can use ICSSPlayback to play audio responses or prompts to the user 

Removes a previously defined context from memory, ICSSRemaveContext can be executed to 
conserve memory. 

Removes remaining active contexts and terminates communication with the ICSS sewer. 
Cleans up ICSS API memory and resources. 


Table 1 . Functions that may be invoked in the ICSS API 
parameters 

* Playback of prerecorded audio 
files. 

The context-switching capability of 
ICSS allows user applications, operat¬ 
ing as speech recognition clients, to 
load numerous contexts and switch 
rapidly among them using the speech 
recognition API calls. The process 
involves activating a grammar for use 
during the recognition search process. 

The API allows multiple applications 
on the same machine to treat the speech 
recognition engine as a successively 
reusable resource; context switching is 
therefore a particularly important tech¬ 
nique when using multiple applications 
in that each application has several 
screens or commands and data entry 
processes. 

Context Development The context devel- 


/i******************************************************************/ 

/* Program name: reco.c */ 
/* OS/2 Developer Magazine, Issue: July/August 1993 */ 
/* Article: Speech Enabling Your Applications With ICSS Is Easy */ 
/* Author: Brandon Booth Phone: 301-240-3671 FAX: 301-240-3377 */ 
/* Description: Program for performing speech recognition. Loads */ 


/* a context and executes it, returning the spoken */ 
/* words, which best match within the context. */ 
/* Program Requirements: Software : OS/2 Version 2.0 or better */ 
/* ICSS */ 
/* IBM ACPA VI.02 Software support*/ 
/* Hardware : 486 OX Processor */ 
/* MicroChannel architecture */ 
/* 5 Meg RAH for ICSS */ 
/* 25 Meg 0AS0 for ICSS */ 
/* IBM M-ACPA card */ 
/* Microphone */ 


/*********+***************************************+*****************/ 

lindude <stdio.h> 
lindude <stdlib.h> 

#include <string.h> 

lindude "icssapi.h" 

Figure 4. Sample program for speech recognition (continued on page 88) 



ICSSStart 

ICSSStartConversation 

KSSDefineContext 


ICSSGetValue 

ICSSSetValue 

ICSSListen 

ICSSGetSpokenWords 

ICSSPlayback 

ICSSRemoveContext 


ICSSEndConversation 

ICSSEnd 
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I 800 IBM-CALL and ask for Department STL If you 
need graphic proof, ask for our evaluation demo which, 
by the way, is rated G. 
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opment environment provides tools for 
activities required to build a speech 
recognition context, including: 


• A context BNF compiler that 
creates word pair, or bigram, 
language models and finite- 
state language models 

• A bigram-by-example language 
model builder 

• A supplemental dictionary 
processor 

• An add-word utility 

• A context test and checkout 
function. 


The ICSS API. Applications interact with 
ICSS through the ICSS API, which con¬ 
sists of eleven 32-bit C-language func¬ 
tion calls. A concept important to under¬ 
standing the API is that application pro¬ 
grams interact with ICSS as both client 
and server. In this case, the application 
is the client and ICSS is the server that 
provides speech-recognition functions. 
As each API function is called, the 
request is passed to the ICSS speech 
server for processing and the results are 
passed back to the ICSS API and 
returned to the invoking application. 

In general, it is necessary to perform 
the following functions to use ICSS: 

• Establish communications with 
the ICSS server facility 

• Establish a conversation with 
that server 

• Define any necessary contexts 
to the conversation to guide 
speech recognition 

• Start the ICSS listening process 

• Wait for any spoken words to 
be returned as text. 

To start associating these basic func¬ 
tions, Table 1 describes the functions 
that may be invoked in the ICSS API. 

To ensure that the ICSS API inter¬ 
acts correctly with the ICSS server, the 
API tracks the order in which these 
functions are invoked and the success 
or failure of each function. This hierar¬ 
chy of function invocation is tracked by 
maintaining a state for the ICSS API for 
each client application. For instance. 


Idefine SIZEBUFFER 256 

void quit (char *msg, long rc); 
void message (char *msg, long rc); 

/***♦***♦******♦*♦♦*♦**♦♦♦♦♦♦**♦♦♦♦♦***♦♦♦♦*♦♦*♦*♦*♦♦*♦♦♦♦*♦♦♦♦♦*♦♦*/ 
/* main */ 

/ft******************************************************************/ 

int main(int arge, char *argv' ) 


char 

inputbuf'SIZEBUFFI 

char 

buffer'SIZEBUFFER 

long 

rc = -1; 

long 

context = 0; 

long 

notdone = 1; 

long 

spoke.too.soon; 

float 

utt.len; 

float 

acq.time; 

float 

reco.time; 

if(argc 

!= 2) 


printf("The reco example program requires one argument.\n"); 
printf("The name of a context to do recognition against.\n"); 
printf(“Example: reco /icss/appl/sarnples/rl/context/rl.m.ctx\n"); 
return 0; 

> 

putsC’Welcome to RECO, the ICSS api example program."); 
rc = ICSSStart(NULL); 

if (rc != ICSS.SUCCESS) quit("Error: Start Failed\rc); 

rc = ICSSStartConversation(ICSS IBMACPA, /* ADCType */ 

ICSS.DEFAULT.INT, /* ADCIFNumber ♦/ 
ICSS DEFAULT STRING, /* FESystemName ♦/ 
ICSS DIRECT, /* FELinkType */ 

ICSS DEFAULT STRING, /♦ RPSystemName ♦/ 
ICSS.DIRECT); /♦ RPLinkType ♦/ 

if (rc != ICSS.SUCCESS) quit("Error: StartConversation Failed",rc); 


/* ContextHandle */ 
/* ContextName ♦/ 
/* InsertionPenalty*/ 
/* LanguageWeight */ 
/♦ GrammarWeight */ 


rc = ICSSDefineContext(&context, 
argv'l , 

ICSS.DEFAULT.FLOAT, 

ICSS DEFAULT FLOAT, 

ICSS.DEFAULT.FLOAT); 

if (rc != ICSS.SUCCESS) 

{ message("Error: Define Context failed",rc); notdone * 0; } 

while(notdone) 

{ 

printf("\nListen?'yes,no >"); 

fflush(stdout); 

gets(inputbuf); 

if( (strstr(inputbuf, M N0" ) != NULL) II 

(strstr(inputbuf,"no" ) != NULL) ) { break; } 

else 

{ 

rc = ICSSListen(context, /* ContextHandle */ 

ICSS.DEFAULT.INT, /* SpeechlnputType */ 

ICSS.LIVE.HIKE, /* SpeechlnputSource*/ 


Figure 4. Sample program for speech recognition (continued from page 87) 
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ICSS must be in a "listen" state to suc¬ 
cessfully perform ICSSListen and in a 
"conversation" state to perform ICSSGet- 
SpokenVords. 

A RNF FOR A CONTEXT 

ICSS uses contexts, derived from com¬ 
piled grammars or bigrams, to guide 
the speech-recognition process. The 
Speech Development Environment 
(SDE) tool set in OS/2 2.1 lets develop¬ 
ers create and test speech recognition 
contexts. 

The most important step in creating 
a context is application design. ICSS's 
context-switching capability allows 
speech-recognition contexts to be 
designed to mirror application struc¬ 
ture. The windowing message structure 
enforced by most popular GUIs can 
provide guidance on organizing 
speech-recognition contexts. The ICSS 
recognition server can switch between 
the preloaded contexts defined for each 
major window. When a particular win¬ 
dow is focused on, it can use the 
speech-recognition API to switch to the 
appropriate speech context. For exam¬ 
ple, a word processor's main window 
might have a "window dressing" con¬ 
text supporting a command structure, 
as shown in Figure 2, This context 
allows a user to speak any of the menu 
options {File, Edit, and so on). 

Developing several small contexts 
makes it possible to reduce the search 
space, or perplexity, during functions 
performed by the application. It also 
reduces error rates when the speech 
recognizer is operating under sub-opti¬ 
mal conditions such as high back¬ 
ground noise. 

A banking application, for example, 
might ask which service is requested 
{loan rates, checking services, new 
accounts, current account status, and so 
on). A context would then be defined 
for each of the expected replies to the 
application's verbal or visual prompts. 
Once the user replies, the context is 
switched and a prompt {such as a 
request for a personal identification 
number, or PIN) is given. The BNF 
form of a PIN context could be set up 
as shown in Figure 3. 


This grammar in Figure 3 defines 
what can be said during a "listen" 
request. The engine will recognize the 
closest phrase in the grammar that 
matches an utterance. The rather sim¬ 
ple context in Figure 3 recognizes only 


digit strings; if the context is active, a 
phrase like "One, two, trees, six" would 
probably be recognized as ONE TWO THREE 
SB. The format works well, however, 
for inputs that do not contain "trick" 
sequences. 
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ICSS DEVELOPER S PROGRAM 

The ICSS Developer's Program 
offers three classes on speech 
recognition. Call (800) 627-8363 for 
an information package. There are 
three packages available: $3995.00 
for a bundle of 23 licenses and 
$299.00- and $699.00 for the small 
and large microphone packages, 
respectively. 


The program consists of a develop¬ 
er's license and tools that enable 
applications for speech, as well as 
the runtime licenses needed to exe¬ 
cute these programs. The package 
also includes a developer's guide 
and a microphone. 

Technical support and develop¬ 
ment assistance is provided via the 
800 number. While there is cur¬ 
rently no technical support provid¬ 
ed on CompuServe, ICSS special¬ 
ists monitor the forums regularly 
and will respond to questions. Call 
(800) 627-8363 for information on 
ICSS demonstrations at trade 
shows and IBM briefing centers. 


REFERENCES 

IBM Continuous Speech Series Devel¬ 
oper's Guide , Developer's Program 
Beta 1, December 1992. 


4 SIMPLE PROGRAMMING 
EXAMPLE 

Figure 4 shows a sample program for 
speech recognition. The program loads 
a context and executes it returning the 
spoken words that best match within 
the context. A copy of this code can be 
downloaded from library 13 in the 
OS2DF2 forum on CompuServe under 
the name "RECO.C." The code will exe¬ 
cute successfully only if ICSS is on the 
system running it. 


NULL); /* SpeechlnputName */ 

if(rc != ICSS_SUCCESS) { message!"Error: Listen Failed",rc); 
break; } 

printf ("\nBEGXN SPEMDGV); 

rc = ICSSGetSpokenWords(SIZEBUFFER-l, /* TextBufferLen */ 

buffer, /* TextBuffer */ 

ftspoke_too„soon, /* SpokeTooSoon */ 

feutt.len, /* UtteranceLength */ 

ftacq.time, /* AcquisitionTime */ 

ftreco.time); /* Re cognition Time */ 

if (rc = ICSS.SUCCESS) 

{ 

printf("The spoken text was: "Xs \n",buffer); 
printf("Utterance Length )(4.2f\n",uttJLen); 
printf("Acquistion Time 7,4.2f\n" ,acq_time); 
printf ("Recognition Time 7»4.2fW,reco_time}; 

else 

{ 

messageO'Error: GetSpokenVords Failed",rc); 
break; 

> 


> 


> 


rc = ICSSEndConversation(); 

if (rc != ICSS_SUCCESS) message("Error: Conversation End Failed \rc); 

ICSSEndtlCSS.LOCAL+ICSSJOFORCE); 

putsf'RECQ Exiting."); 
return 0; 


void quit(char *msg, long rc) 


{ 


printf("'/.s rc=Xd 7s\n\nsg,rc JCSSErrorString'rc ); 

exit(*l); 

return; 


void message(char *msg, long rc) 

printf("Xs rc=Xd Xs\n" J msg,rc,ICSSErrorString'rc ); 
return; 

} 


Figure 4. Sample program for speech recognition (continued from page 88) 
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developing DSP-based systems for speech 
recognition, sonar , biomedical, seismic r 
speech „ and acoustic signal classification 
systems. 
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The IBM OS/2 32-Bit Porting and Technical Consulting Workshops give developers hands-on training and assis¬ 
tance in application porting, by MARILYN JOHNSON 

OS/2 32-Bit Porting and 
Technical Consulting Workshops 


/ BM is offering developers a way to port exist¬ 
ing DOS, Windows, UNIX, and 16-bit OS/2 
applications to 32-bit OS/2 with the IBM 
OS/2 32-Bit Porting and Technical Consulting 
Workshops, which provide hands-on training and 
assistance in application porting. The workshops 
focus on OS/2 32-bit features such as thread man¬ 
agement, multitasking, robust memory manage¬ 
ment, and full 32-bit APIs, with a focus on posi¬ 
tioning applications for portability* 

The workshops are led by industry experts who 
maintain expertise in current and future technolo¬ 
gy and have extensive experience in porting to 32- 
bit platforms. Workshop leaders' experience with 
application porting allows: 

* Accurate sizing of the migration effort 
* A minimized learning curve 
* Architectural integrity 
• A shortened development cycle 
* 35% to 100% of code ported. 

AH workshops include extensive hands-on port¬ 
ing of code brought in by the participants. The price 
of each workshop includes meals, the use of lab 
hardware, and software to take home. Participants 
also receive class materials, the OS/2 2.1 operating 
system, and C Developers' Workset/2 and Multi- 
media Presentation Manager/2 (MMPM/2). 

WINDOWS 3.X TO OS/232-BIT PRESENTATION 
MANAGER NATIVE WORKSHOP 

This five-day workshop is for Windows 3.x appli¬ 
cation developers who want to expedite porting 


Windows code to the 32-bit OS/2 platform, allow¬ 
ing Windows 3.x applications to exploit OS/2 
memory management, multithreaded design, and 
the Presentation Manager (PM) interface. The 
workshop involves extensive hands-on porting of 
developers' source code, including instruction and 
assistance from a porting expert. 

The workshop highlights architectural changes 
necessary to port, including comparisons between 
Windows 3.x and OS/2 program design and dis¬ 
cussion of the Windows 3.x 16-bit segmented 

The workshops focus on features 
such as thread management, multi¬ 
tasking, robust memory management, 
and full 32-bit APIs, with a focus on 
positioning applications for portability. 


memory management versus the 32-bit flat 
address space of OS/2 2.1. Students explore the 
benefits of OS/2 memory pools, guard pages, 
shared memory, page allocation techniques, and 
multi-threaded design. 

The workshop also covers programming to PM 
under OS/2 2.1. Participants will discuss forms of 
interprocess communication that allow OS/2 
processes to share and pass data and also compare 
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the OS/2 DOS APIs to functions provid¬ 
ed with the C run-time environment. 
The workshop covers common controls 
(such as the container, notebook slider, 
and value set) and common dialogues 
(such as the file and font dialogues). 


now a part of the OS/2 operating sys¬ 
tem, Finally, the class looks at the 
MMPM/2 Toolkit and its features. 

As part of the Windows 3.x to OS/2 
32-bit workshop, attendees use new 
porting tools that help convert applica¬ 


tions to the OS/2 2,1 PM platform. 

Prerequisites for this workshop are 
Windows 3,x and C programming 
experience as well as an existing Win¬ 
dows 3.x application. 

DOS TO OS/2 32-BIT PRESEN¬ 
TATION MANAGER WORKSHOP 

This seven-day workshop is for DOS 
application developers who want to 
port existing applications to the OS/2 
32-bit PM platform, allowing DOS 
applications to exploit OS/2 memory 
management, multithreaded design, 
and the CUA PM interface. The work¬ 
shop involves extensive hands-on port¬ 
ing of the developer's source code, 
including instruction and assistance 
from a porting expert. 

During the week, experts discuss 
how to map BIDS-based functions to PM 
APIs and how to redesign the user 
interface,to take advantage of PM pro¬ 
gramming, It also covers those 32-bit 
OS/2 functions equivalent to DOS HIT 
functions, 

OS/2 32-bit flat addressing memory 
management, making the best use of 
OS/2 l s virtual address space, OS/2 
memory pools, guard pages, shared 
memory, and page allocation tech¬ 
niques are all covered. 

The concepts of multitasking with 
OS/2 processes and threads are dis¬ 
cussed in depth. Topics include inter¬ 
process communication and offloading 
work to multiple processes and threads 
of execution. 

Common controls that allow DOS 
programmers to spend more time on 
code specific to their application are 
reviewed, then the instructor demon¬ 
strates how to incorporate MMPM/2 
into newly ported OS/2 applications. 

Prerequisites for this workshop are 
DOS and C programming experience 
as well as an existing DOS-based C 
application. 

SYSTEM OBJECT MODEL/ 
WORKPLACE SHELL WORKSHOP 

This five-day workshop provides 
detailed information about OS/2 32-bit 
System Object Model (SOM) program- 
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ming. It shows how to interact with the 
Workplace Shell and takes advantage 
of future SOM enhancements with min¬ 
imal impact on source code. The work¬ 
shop features extensive hands-on appli¬ 
cation development. 

During this week, the instructors 
discuss similarities and differences of 
SOM and C++ as well as differences 
between Workplace Shell and non- 
Workplace Shell applications, identify¬ 
ing which modules should or should 
not become Workplace Shell objects. 

Attendees learn how to integrate 
existing OS/2 applications into the 
Workplace Shell by sub-classing exist¬ 
ing SOM and Workplace Shell objects, 
enabling applications to take advantage 
of the methods and default actions pro¬ 
vided by the object-oriented Workplace 
desktop. 

Prerequisites for this workshop are 
32-bit OS/2 and C programming expe¬ 
rience, as well as knowledge of the 
principles of object-oriented program¬ 
ming. 

OS/216-BIT PRESENTATION 
MANAGER TO 32-BIT PRESEN¬ 
TATION MANAGER WORKSHOP 

This five-day workshop enables OS/2 
developers to port their existing C 
applications to the OS/2 32-bit PM 
platform. This includes taking advan¬ 
tage of the flat memory model, better 
interprocess communication, and 32-bit 
execution vs. "thunked" 16-bit code. 
The workshop involves hands-on port¬ 
ing of the developer's source code, 
complemented by instruction and assis¬ 
tance from a porting expert. 

Differences between 16-bit and 32- 
bit OS/2 subsystems, focusing on areas 
such as the new memory model, are 
reviewed. OS/2 2.1 flat memory 
addresses vs. 16-bit segmented memo¬ 
ry architecture are discussed, as are 
new memory features such as sparse 
memory objects and page guards. The 
class explores how 16-bit modules com¬ 
municate with 32-bit modules and the 
ramifications of 'Chunking" to 16-bit 
code. 

The instructors then address thread¬ 


ing features available in OS/2 and 
OS/2 2.1, including suspending and 
resuming threads of execution and the 
system's ability to manage stack mem¬ 
ory for applications using threading. It 
then covers the changes and enhance¬ 
ments to interprocess communication 
between processes and threads. 

The workshop focuses on the new 
and changed Base Services APIs and 
their C run-time counterparts; it also 
introduces 05/2's common controls 
and and standard dialogues, which 
reduce the code required to perform 
common interfaces (for example, pro¬ 
viding a dialogue of drives, directories, 
and files). Finally, It covers perfor¬ 
mance enhancement aids and tools, an 
introduction to MMPM/2, and adding 
multimedia to OS/2 applications. 

Prerequisites for this workshop are 
experience in OS/21.x and C program¬ 
ming and an existing OS/2 1.3 applica¬ 
tion. 

UNIX TO OS/2 32-BIT WORKSHOP 

This five-day workshop is for UNIX/X- 
Windows application programmers 
who want to port or reimplement 
applications on the OS/2 32-bit plat¬ 
form and also for programmers who 
want to include OS/2 in their UNIX 
environment. The workshop fosters a 
broad-based understanding of OS/2 
components by comparing UNIX and 
OS/2, which helps developers under¬ 
stand how to provide existing applica¬ 
tion function in the OS/2 environment 
and how to exploit unique features of 
OS/2 to extend or enhance existing 
function. Capabilities and interfaces 
common to both UNIX and OS/2 are 


emphasized to expedite porting and 
preserve application architecture and 
design wherever possible. 

During this workshop, instructors 
give an overview of OS/2 and identify 
the programming environment and 
development process. The class com¬ 
pares OS/2 and UNIX-based operating 
system concepts, interprocess communi¬ 
cation using shared memory, pipes, 
queues, semaphores, transmission con- 

All workshops include 
extensive hands-on 
porting of code brought 
in by the participants 



trol protocol/internet protocol (TCP/IP) 
sockets and RPC, NetBIOS, and SNA 
basics. The class discusses the interoper¬ 
ability of X-Windows and PM and OS/2 
security in standalone and LAN envi¬ 
ronments. 

Prerequisites for this workshop are 
UNIX/X-Windows and C program¬ 
ming experience as well as familiarity 
with standard development tools. 

Marilyn Johnson, IBM Corp. t 1000 N.W, 
51st St, Boca Baton, F l a. 33431. Johnson 
has been with IBM since 1980 and with the 
worldwide Developer Assistance Program 
since 1989 . She is the program manager 
for the porting and technical consulting 
workshops . 


WORKSHOP LOCATIONS AND INFORMATION 

Workshops are held in West Palm Beach, Fla. and Dallas, Texas. The UNIX to 
OS/2 32-bit workshop is held at the IBM site in Austin, Texas. 

For more information, call One Up Corp. at (8QG) 678-3187 Monday through 
Friday, 8:00 a.m. to 5:00 p.m. Central time. Refer to the IBM OS/2 Porting and 
Technical Consulting Workshop. 
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Since 32-bit OS/2 was released last year, more than 1,200 OS/2 applications have appeared 
on the market. Each issue, this column will note new product releases in the OS/2 world. 


New Products, New Support 


TOOLS 

Borland C++ for 0S2. Borland's new C++ 
for OS/2 makes quick creation of pow¬ 
erful C and C++ applications easy with a graphical 
environment and a suite of visual tools, including 
Turbo Debugger GX. C++ includes an optimizer 
for 32-bit code generation and is designed with 
ANSI C Certification and AT&T C++ standards. 

Borland International Inc. 

Phone: (800) 331-0877 Fax: (408) 439-9103 



to maximize developer productivity. Included in 
this package is the IBM high-performance C Set/2 
compiler and debugger, the IBM WorkFrame/2 
project-oriented development environment, and 
the IBM Developer's Toolkit for OS/2, which fea¬ 
tures a collection of language-independent build 
tools, productivity tools, sample programs, refer¬ 
ence information, and a kernel debugger IBM also 
offers a free quarterly compiler newsletter that can 
be ordered by fax. 


Digitalk PARTS Workbench for OS/2 . The PARTS 
Workbench is a 32-bit client/server technology 
integration tool that lets programmers assemble 
and reuse parts. The product comes with 67 visual 
parts (Window, Button, and Text Pane) and nonvi¬ 
sual parts (dynamic data exchange, launch pad, 
and Btrieve). These components, plus others from 
Digitalk and third-party vendors, can be linked 
together to form applications. 

Digitalk 

Phone: (800) 531-2344 Fax: (310) 6454306 

HockWare VisPro/REXX, VisPro/REXX helps pro¬ 
grammers create powerful and professional OS/2 
2.x programs with REXX in a GUI environment. 
VisPro/REXX exploits all OS/2 controls while 
enabling all the REXX features, including interac¬ 
tive debugging, APPC, HLLAPI, and OS/2 Data¬ 
base Manager interfaces. 

HockWare Inc. 

Phone: (919) 387-7391 Fax: (919) 380-0757 


IBM Corp. 

Phone: (800) 342-6672 

Fax: (416) 448-6057 (for newsletter only) 

PSS Tape Solution Series, Parallel Storage Solutions 
offers their Tape Solution Series, the only tape- 
backup on the market specifically designed for use 
with OS/2. For independent or network users, it 
protects data quickly and efficiently. Coupled with 
a tape backup device, the software provides the 
fastest backup speed on the market. 

Parallel Storage Solutions 

Phone: (800) 998-7839 Fax: (914) 347-4646 

WATCOM C/C++32 . C/C++32 is a 32-bit multiplat¬ 
form optimizing compiler package with a compre¬ 
hensive toolset, including a debugging system, 
profile, linker, make utility, and other tools. 
C/C++32 features include full C++ implementa¬ 
tion with templates, exceptions and nested types, 
and an advanced code generator with 486 and 
Pentium optimization. 


IBM C Developers Workset/2 . The C Developer's 
Workset/2 consists of several programs designed 


WATCOM 

Phone: (519) 886-3700 Fax: (519) 747-4971 
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APPLICATIONS 


Cirrus Unite 2ft Unite is an integrated 
client/server-based document imaging 
solution designed to reduce paper handling while 
increasing productivity. A true multitasking appli¬ 
cation for LAN use. Unite 20 supports optical juke¬ 
box technology for storage, fax, and print output. 

Cirrus Technology Inc. 

Phone: (301) 698-1900 Fax: (301) 698-1909 

lotos Applications. Lotus has recently shipped sev¬ 
eral of its most popular applications rewritten for 
OS/2 2.x to take advantage of multithreaded full 
32-bit support. The OS/2 2.x versions of Ami Pro, 
1-2-3, Freelance Graphics, Notes, and cc:Mail all 


offer drag and drop capabilities and Workplace 
Shell integration. 

Lotus Development Corp. 

Phone: (800) 872-3387 

WordPerfect 52 for OS/2. WordPerfect 5.2 is a graphi¬ 
cal word processing program that includes popular 
features such as the Button Bar, ruler, QuickFinder, 
and QuickMenu, as well as drag-and-drop capabili¬ 
ties and new macros. It supports all documents cre¬ 
ated in previous versions of WordPerfect. 

WordPerfect Corp. 

Phone: (800) 451-5151 Fax: (801) 222-5077 



DEVELOPER SUPPORT 

IBM Developer Connection for OS/2. The 

IBM Developer Connection for OS/2 is 
a new service designed to provide OS/2 develop¬ 
ers with the technical information needed to create 
OS/2 applications. The Developer Connection will 
also feature updated information, tips, techniques, 
sample applications, and beta code for upcoming 
IBM applications. 

The service, which consists of quarterly CDs 
and newsletters as well as electronically-accessible 
developer support, costs $199.95 per year. How¬ 
ever, developers who sign up for the Developer 
Connection before September 30,1993 are eligible 
for an introductory price of $149,95 per year. 

For more information about receiving the 
Developer Connection, call 1-800-633-8266. 

Hew LV> League Catalog. The IBM OS/2 Indepen¬ 
dent Vendor (I,V.) League showcases hundreds of 
books, magazines, courseware, and consulting ser¬ 
vices that support OS/2. Now, select member 
products are featured in the all new l.V. League 
Product Catalog. To order a free copy, call 1-800- 
342-6672. 



If you would like to contribute to this column , 
please contact Product Watch, OS/2 Developer, 
600 Harmon San Francisco , CA 94107, fax: 
(415) 9052234. 


OS/2 CALENDAR 

August 24-26 

Business Software 

Solutions Conference 
(formerly Windows & OS/2 
Conference), Boston 
(415) 905-2784 

August 29- 
September 2 

IBM Technical Interchange, 
Orlando (800) 872-7109 

September 9 

C.A.M.P., Chicago 
(708) 291-1360 

October 5-8 

NetWorld, Dallas 
(800)829-3976 

October 19-21 

PC Expo, Chicago 
(800)829-3976 

October 31- 
November 5 

ColoradOS/2, 

Colorado Springs 
(719)481-3389 


JULY/AUGUST 1993 


95 


mu 






















you wouldn’t think 

ABOUT REINVENTING THE 
VHEEL...VHY REINVENT 
REASONING? 




Take a quantum leap forward with The Integrated 
Reasoning Shell (TIRS). TIRS offers: 




Speed 

Fast performance with 32-bit processing 


H Productivity 

Reduce development and maintenance 
time 



Embeddability 

Fully integrates with your application 



Flexibility 

Do It your way- Use your favorite DBMS 


TIRS features include multiple platforms (OS/2, 
VM, and MVS), frame-based reasoning with 
inheritance, a code generator (C and PL/I), 
and a GUI development environment 

For more information about TIRS, our other 
OEM offerings, and our two month product 
trial period, call: 

1-800-IBM-SOLV flU 

Outside the US: (408) 463-4381 

IBM, TIRS. and OS/2 a m rwtawta of IntornaikroJi fjysinoss Machine Corporation. 



Company and fax no. R,S, no, 

Borland International Inc.: (408)439-0115 CGV4 

Burton Systems Software: {908)233-0716 79 

Cognitive Software Inc. 53 

Computer Associates 4 

Creative Systems Programming: (609) 234-1920 60 

dSoft Development: (713) 378-7448 79 

Essex Systems Inc.: (508) 750-4699 53 

Easel Corp.: (617)221-3099 19 

Gpf Systems Inc.: (203)873-2171 10 

Hookware: (919) 380-0757 15 

IBM Canada: (800) 445-2426 35 

IBM Programming Systems Cary Labs: (919) 469-7423 43 

IBM CUA Controls Library: (919) 469-4423 27 

IBM (DB2)—Programming Systems 59 

IBM GIK: 011-43-1-21145-4490 87 

IBM IV League 32a 

IBM Personal Software Products: (407) 982-6408 54-55 

IBM Speech Recognition: (301) 240-3377 13 

IBM TIES 96 

IBM LLS. Marketing and Services: (904) 238-3442 48a 

IBM Programming Systems (WITT) 17 

Information Builders Inc.: (212) 629-8819 46 

Intersolv 37 

Impact Software: (818)879-5593 53 

Intelligent Environments: (508) 750-4699 24 

Kaseworks: (404) 448-4163 21 

Microformatic: (203) 648-9587 61 

Micropolis: (612) 341-2114 22-23 

Microway: (508)746-4678 85 

Mi tnor Software: (918)357-2869 92 

MSR Development: (409) 560-5964 77 

Micro Focus: (415) 856-6134 2 

Prentice Hall: (800) 448-3804 85 

Real Time Technologies: (708) 446-6886 53 

Rightware Inc. 27 

Sequiter: (403)436-2999 COV3 

Softbridge: (617)864-7747 69 

Softouch Systems Inc. 99 

Software Development Conference 1993 80-81 

Soft and GUI: (718)934-2133 29 

Softronics Inc: (719) 548-1878 11 

Stac Electronics: (619) 431-1001 30 

Token Technology: (408) 559-8661 65 

Van Nostrand Reinhold 51,101 

Watcom C for IBM PCs: (519) 747-4971 COV2,l 

Zinc Software: (801) 785-8996 41 










This article provides an in-depth walk-through of debugging routines using the REXX programming language's 
trace command. Programs can be tested entirely inside REXX without the use of external debugging tools. 

BY STEVE CLARK 


Debugging REXX Applications 


/ n The REXX Language : A Practical Approach to 
Programming f author Michael Cowiishaw 
states that the single design objective of REXX 
was "to make programming easier than it was 
before." The simplicity of REXX allows program¬ 
mers to deal more directly with the logic of a pro- 
gram. 

The same design objective was applied to 
debugging REXX code. The REXX language 
includes many debugging features to make test¬ 
ing and debugging easier* Understanding where 
and how these debugging aids are used can 
improve the quality of your code and the efficien¬ 
cy of the development testing, debugging, and 
documentation process. 

Most of the information and examples here are 
appropriate for all REXX operating environments. 
Specific OS/2 features are clearly noted. 

DEFINING TRACE ACTION 

The REXX language processor offers many trace 
actions for use in debugging. Setting a trace action 
determines the amount of trace information to be 
displayed and whether the trace is run interac¬ 
tively. This can be controlled within a REXX pro¬ 
gram by the TRACE instruction or the built-in TRACE () 
function. These share most of the same parame¬ 
ters and can be used interchangeably in many sit¬ 
uations. 

The trace action is defined by a single parame¬ 
ter made up of either a whole number or an alpha¬ 
betic characterfyord) option. The number trace para¬ 
meter is only valid during interactive tracing. The 
most commonly used alphabetic character (word) 
options are: 

* Normal. Failed commands are traced after 


execution. This is the default setting. 

* Off. All tracing is turned off* 

• Results. All clauses are traced before exe¬ 
cution and results are displayed. This is 
the most common option. 

* Intermediates. This option is similar to 
Results, but intermediate results are also 
displayed. 

• Labels. All labels are traced as they are 
passed. 

REXX recognizes an option by the first letter of 
its name so it is not necessary to type the full 
name* The alphabetic character(yord) option may 
also include one or more question mark (?) prefix 
characters. The question mark prefix acts as a 
switch turning interactive tracing on and off* 
Examples of setting the REXX trace action using 
the trace instruction are shown in Figure 1* 

REXX trace parameters are described in detail 
in the OS/2 2.0 Procedures Language 2/REXX refer¬ 
ence manual. 



Steve Clark 


DIFFERENCES BETWEEN TRACE AND 
TRACEO 

If the TRACE instruction and the TRACEO function are 
so similar, why is it necessary to have both? In 
practice, the TRACE instruction is sufficient for most 
debugging tasks, and its simpler syntax is quicker 
to use* There are differences, however, between 
the two commands* The TRACEO function has some 
unique features that make it a necessary and valu¬ 
able debugging aid. 

The most obvious difference between TRACE and 
TRACEO is that the TRACEO function returns a result* 
The result is the current TRACE action. You can 
invoke the TRACEO function directly within an 
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expression, and the result will be eval¬ 
uated as part of the expression. Alter¬ 

TRICE OFF 

/* Trace off 

*/ 

natively, the TRICEO function can be 
invoked with the CALL instruction and 

TRICE 0 

(* Trace off 

*/ 

the returned result will be assigned to 
the special variable RESULT. Examples of 

TRICE ?R 

fa Trace results - interactive */ 

calling the TRICEO function are shown 
in Figure 2. 

TRACE I 

fa Trace intermediate results 

*/ 


Also, like other functions, TRICEO 
evaluates its option as an expression, 
whereas the TRUCE instruction evaluates 
its option as a constant. The TRUCE 
instruction is defined this way to sim¬ 
plify the syntax of the command and 
avoid surprises to the programmer. 
The instructions TRICE I or TRICE OFF will 
always set the expected trace action. 
However, using CALL TRICE I or CALL 
TRICE OFF may generate some unexpect¬ 
ed trace behavior if the symbols i or off 
have been assigned values. Figure 3 
illustrates that it is necessary to be 
explicit when using the TRICEO function 
and delimit the option with quotes. 

The intent in Figure 3 is to set the 
trace action to Intermediates. Instead of 
doing so, the language processor evalu¬ 
ates the variable i, which has been 
incremented to 11 by the do i=l to 10 
loop. What is actually executed is CALL 
TRICE 11. 


Figure t Sample TRICE instructions 


trace.value = TRICEO 

fa Get trace option */ 

trace.value = TRACE('ft') 

fa Get option and set results */ 

CALL TRACE 'TR" 

/* Set results - interactive */ 


Figure Z Sample TR ICE () function calls 

after most clauses for input from the 
keyboard. One exception is the TRACE 
instruction. Following a TRICE instruc¬ 
tion, the language processor will con¬ 
tinue to execute until the next pause. 
This is true whether the TRICE instruc¬ 
tion is in the file or entered from the 


Interactive trace allows programmers to monitor 
program execution, change variables, reexecute 
clauses, execute program routines, and even alter 
program flow. 


summarized in Figure 4, 

TRACE OUTPUT 

As each clause is executed, the trace 
output is displayed to the user. The dis¬ 
play contains the executed source line 
number and text. A special symbol is 
also displayed to indicate the type of 
data being displayed. The *-* symbol 
indicates that the displayed data is the 
source text of the executed clause. The 
+++ symbol indicates a trace message 
from the language processor. 

When results are displayed, they are 
indicated by symbols that begin and 
end with the greater than sign (>). 
These symbols are shown in Figure 5. 


This example points out another dif¬ 
ference. The number parameter, while 
valid for the TRICE instruction, is not 
valid for the TRICEO function. Using the 
number parameter with a call to the 
TRICEO function will generate a syntax 
error. 

The less obvious differences 
between the TRICE instruction and the 
TRICEO function become apparent dur¬ 
ing interactive tracing; during interac¬ 
tive trace, the REXX processor pauses 


keyboard. In contrast, the language 
processor pauses after the TRICEO func¬ 
tion, as it does for all functions. 

Another difference is that during 
interactive trace, trace control is trans¬ 
ferred to the console. All TRICE instruc¬ 
tions in the program file are ignored. 
Only keyboard TRICE instructions are 
obeyed until interactive trace is 
switched off. In contrast, the TRICEO 
function is never ignored. The differ¬ 
ences between TRICE and TRICEO are 


INTERACTIVE TRACE 

Interactive trace allows programmers 
to monitor program execution, change 
variables, reexecute clauses, execute 
program routines, and even alter pro¬ 
gram flow. The REXX processor pauses 
following the execution of most clauses 
and allows programmers to enter 
instructions from the console. In fact, 
all REXX instructions may be entered 
from the console during interactive 
trace. 

In addition, there are two special 
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Figure 3. Invalid TRUCE () function call 

instructions that control execution dur¬ 
ing interactive trace. These two instruc¬ 
tions are the null line and the equal 
sign (=). Entering a null line by pressing 
the enter key will cause the processor 
to execute the next clause and continue 
executing until it reaches the next 
pause* 

Entering an = will reexecute the last 
clause traced In the current routine. 
This is an extremely useful command 
when used in conjunction with the 
available REXX instructions. If you are 


using the Results trace action and come 
across a complex line of code, you can 
switch the tracing action to Intermediates 
by executing the TRACED function from 
the keyboard and then reexecuting the 
clause* The TRUCE () function is used so 
the language processor will pause and 
not continue to the next clause. 

Figure 6 demonstrates this scenario* 
In the first execution of the clause, you 
can see that the variable * was com¬ 
pared to the result of the VERIFY () func¬ 
tion and the result of that comparsion 
is 0 or false* But since the values of the 
variables in this clause are unknown, it 
is difficult to see how the result was 
determined. So the trace action is 
changed with the TRUCE (} function and 
reexecuted to get more detail* The 
Results symbols now show that the vari¬ 
able (>V>) V equals 1, string contains a 
date, delim.list contains a list of delim¬ 


iters, and that there is a literal (>L>) 
string M. The VERIFY function(>F>) has 
returned 3, the comparison operation 
(>0>) returned 0, and the final result is 0. 

During an interactive trace, vari¬ 
ables can be examined with the SAY 
instruction. The semicolon can be used 
to enter multiple clauses on a line. In 
fact, the processor requires that all 
instructions such as DQ***END and 
IF,. .THEN be complete when entered, as 
in Figure 7, 

While monitoring the program exe¬ 
cution and examining the variables 
with the SAY instruction or through 
trace results, changing a variable's 
value is invariably useful. Variables can 
be modified with an ASSIGNMENT instruc¬ 
tion, as In Figure 8. 

Program subroutines can be execut¬ 
ed directly from the keyboard with the 
CALL instruction. Subroutines can also be 
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exited at any point with the RETURN 
instruction. This means that a program¬ 
mer can dramatically alter program 
flow. 

Program execution can also be halt¬ 
ed with the EXIF instruction, although it 
is better to exit by calling the program's 
exit subroutine (for example, CALL 
EXIT_PR0G). The exit subroutine would 
have been coded to perform any neces¬ 
sary cleanup, such as dropping queues 
or deleting temporary work files. 


CONTROLLING INTERACTIVE 
PAUSES 

Two trace options control pausing dur¬ 
ing interactive tracing. One of these is 
the Labels option. This option changes 
the trace action to only trace and pause 
at label clauses* This is useful for limit¬ 
ing the amount of trace output and 
quickly progressing to the next subrou¬ 
tine of interest. Once a desired subrou¬ 
tine is reached, changing the trace 
action to Results or Intermediates will 
resume tracing of all clauses. 

TRACE L is also useful when examin¬ 
ing unfamiliar programs* Since only 
labels are traced, it can be used to gen¬ 
erate an outline of the program flow 
showing the order in which each sub¬ 
routine is executed. 

The other trace option used for con¬ 
trolling interactive pauses is the num¬ 
ber option. When a positive whole 
number is used as a trace option, the 
designated number of pauses will be 
ignored. Using a negative whole num¬ 
ber has the same effect on pausing, but 
trace output is suspended for the desig¬ 
nated number of pauses. 

The number option is most useful 
for debugging loops. After stepping 
through a loop once, the number 
option can be used to initiate a full exe¬ 
cution of the loop without pausing. 

INTERACTIVE TRACE OFSUBROU- 
TINES 

When a subroutine is to be traced, the 
programmer can start interactive trac¬ 
ing by adding a TRACE instruction to the 
source either within the subroutine or 
prior to the call to the subroutine. In 
either case, the subroutine will be 


100 


Alter trace action from keyboard 

TRACE 

y 

TRACEO 

y 

Result returned 

H 

T 

Option is taken as a constant 

y 

H 

Pause after TRACE clause 

N* 

Y* 

Ignored in file during interactive tracing 

Y 

N 

Accept number option 

y 

H 

No parameter sets default trace action 

y 

H 


* Note: The pause behavior of the TRACE instruction and the TRACE() 
function when entered at the keyboard during interactive trace 
is not consistent in all implementations or versions of REXX* 


Figured TRACE vs. TRACEO behavior 


When the trace action is set to 'Results' with 
the 'R' trace option, the results are preceded by 
the following symbols: 

»> Results of an expression including assignments made with the parse 
instruction* 

>.> Value assigned to the period (V) placeholder during parsing* 

When the trace action is set to display 'Intermediates' with the 'I' trace 
option, then the following additional result symbols are used to identify 
the intermediate results: 

>C> Resolution of a compound symbol (symbols which contain a 

period). The value shown is not the value assigned the symbol 
but the stem portion of the symbol and the resolved components 
of the taH. Compound symbols are described in depth in the 
OS/2 2.0 Procedures Language 2/REXX Reference manual* 

>F> Result of a function call. 

>L> Literal. 

>0> Result of an operation on two terms. Operations include 
arithmetic, comparison and concatenation. 

>P> Result of a prefix operation (+ or ~). 

>V> Contents of a variable. 


Figure 5* Symbols used in trace output 
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9 *-* 

If x = verify(string, delUJist, 


»> 

"0" 


Enter; 

CULL TRACE 'I' 


Enter; 

- 


9 *-* 

If x = verify (string, delimJLLst, 

'M'); 

>Y> 

it i h 


>V> 

"01/17/92" 


>v> 

‘7- 


>L> 

"IT 


>F> 

"3" 


>0> 

"0" 


»> 

"0" 



Figure 6 , Reexecuting a clause to get intermediate results 


traced. The difference is the program- subroutine. Both approaches have their 
mer's control prior to and following the advantages. 


Inserting a trace instruction within 
a subroutine will cause tracing to begin 
after entering the subroutine. There is 
no need to change the trace action 
when the subroutine ends. That hap¬ 
pens automatically. The trace action of 
the caller is saved, and when control 
returns to the caller, that trace action is 
restored. 

If a subroutine is called from numer¬ 
ous points in a program, it is not neces¬ 
sary to locate each call and add a TRICE 
instruction. Instead, a single TRICE 
instruction within the subroutine will 
turn tracing on each time the subrou¬ 
tine is executed. However, because 
tracing does not begin until after entry 
into the subroutine, it is not apparent 
where the call to the subroutine was 
made or what the source of the subrou¬ 
tines parameters were. Fortunately, 
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REXX provides a special variable and 
a built-in function for retrieving this 
information. The special variable SIGL 
contains the line number of the clause 
that transferred control to the subrou¬ 
tine, as shown in Figure 9. The built-in 
function SOURCELINE() used with the spe¬ 
cial variable SIGL will return the exact 
text of the clause that called the active 
subroutine. 

Adding a trace instruction prior to 
the call to a subroutine establishes the 



Figure 7. Examining variables with SAY 


By modifying the 
variables that make up 
the calling parameters 
and repeatedly calling a 
subroutine, subroutines 
can be fully tested in a 
single execution of the 
program. 


trace action prior to, during, and after 
the execution of the subroutine. This 
allows a programmer to see exactly 
where the call takes place. It provides 
an opportunity to see and modify the 
subroutine's calling parameters and to 
see and modify the result when the 
subroutine returns. It also allows the 
programmer to easily reexecute the 
subroutine. 

Since the REXX processor does not 
pause following a trace instruction, it is 
recommended that a NOP instruction be 
added following the TRACE instruction. 
The language processor will pause after 
the NOP instruction, which provides an 
opportunity to examine and possibly 
modify variables before entering the 
subroutine. The DEBUG_RX.CMD pro¬ 
gram illustrates this with the clause 
TRACE ?R; NOP just before the call to the 



Figure 8. Altering program flow with an ASSIGNMENT instruction 



Figure 9. Displaying a subroutines caller 

DIFF subroutine. The TRACE instruction is 
used instead of the TRACEO function 
because it is ignored if interactive trace 
is already switched on. 

When the tracing action is set prior 
to calling a subroutine, that action will 
be in effect after the subroutine ends. 
The programmer can take advantage of 
this by using the equal sign (=) trace 
command to re-execute the call to the 
subroutine. The = reexecutes the last 
clause traced in the current routine. 
After control is returned to the caller by 
the RETURN instruction, the last clause 
traced in the current routine is the 
clause that called the subroutine. 
Therefore, entering = will reexecute the 


call to the subroutine, as shown in Fig¬ 
ure 10. 

This is an extremely efficient debug¬ 
ging technique. By modifying the vari¬ 
ables that make up the calling parame¬ 
ters and repeatedly calling a subroutine 
in this manner, subroutines can be fully 
tested in a single execution of the pro¬ 
gram. 

When using this technique, it may 
be desirable to quickly return to the 
calling routine and reexecute the sub¬ 
routine. There are two ways to do this. 
Entering TRACE OFF will turn off tracing 
until the subroutine returns to the 
caller. Entering the RETURN instruction 
will change the program flow and force 
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an immediate return to the caller. If the 
RETURN instruction is used in a subrou¬ 
tine called as a function, it must return 
a result, such as RETURN 0, or a syntax 
error will be generated. 

Once a tracing action is set, it will 
apply to any called subroutines. If 
there is no interest in tracing a subrou¬ 
tine, entering TRUCE OFF will switch off 
tracing until that subroutine ends. But 
if a program contains a subroutine that 
is called repeatedly, such as a logging 
or messaging routine, it can be an 
annoyance to constantly be switching 
off tracing from the keyboard. In this 
instance, it is preferable to program- 
maticaly switch trace off with a clause 



During 

development, it can 
be very efficient to 
write and test many 
routines externally. 


in the offending subroutine. TRACE 
instructions in the program cannot be 
used for this purpose because they are 
ignored during interactive trace. But 
the TRACEO function can be added to a 
subroutine to programmaticaly switch 
tracing off. 

USING EXTERNAL ROUTINES 

Re-executing subroutine calls with the 
equal sign (*) trace command works 
very well with external routines. 
Whereas an internal routine cannot be 
changed and retested without ending 
and restarting the program, an external 
routine can be modified between calls 
without ending the calling program. 
During development, it can be very 
efficient to write and test many rou¬ 
tines externally. Once testing is com¬ 
pleted, they can be converted to inter¬ 
nal routines. If the file name of the 
external routine is kept the same as the 


/* When DEBUG_RX.CMD is executed with the trace instruction 

♦/ 

/* suggested above, the trace scenario might proceed as shown here. 

♦/ 

12 *-♦ 

Nop; 


♦-M- 

Interactive trace. "Trace Off" to end debug, ENTER to Continue. 

Enter: 

say yrl yr2 sz /* Examine variables 

00 10 2 

♦/ 

Enter: 

/* Step through subroutine 

*/ 

13 

call diff yrl, yr2, sz; 


24 *-♦ 

Diff: /* Start of subroutine 

*/ 

Enter: 

trace -6 /* Suspend trace for 6 lines ♦/ 

32 

i 

X 

II 

V) 

c 

fO 


»> 

MO" 


33 ♦-* 

If abs(ans) >= abs(( x ♦ z) - y ); 


»> 

"0" 


34 

If abs(ans) >= abs(x - ( y ♦ z) ); 


»> 

"0" 


35 

Return rc; /♦ Return to caller 

*/ 

»> 

M0" 


»> 

M0" 


Enter: 

yrl = 50 /* Change calling parameter 

*/ 

Enter: 

= /* Re-execute subroutine 

♦/ 

13 *-♦ 

call diff yrl, yr2, sz; 


24 *-* 

Diff: /* Start of subroutine 

♦/ 


Figure 10. Reexecuting a subroutine in interactive trace 


label, then the only conversion is to 
copy the routine into the program. 

In determining if this development 
technique is appropriate, keep in mind 
that there are no external variables in 
REXX. All of the caller's variables are 
hidden from an external routine just as 
if a PROCEDURE instruction were used. The 
DIFF subroutine in the DEBUG_RX.CMD 
sample program is an example of a rou¬ 
tine that can be used unchanged either 
as an internal routine or as an external 
REXX routine. 0IFF does not use any 
variables from the caller's environment. 


It receives data through the calling argu¬ 
ments and returns data to the program 
as a result. To convert DIFF to an external 
routine simply copy the routine into a 
file named DIFF.CMD and delete it 
from the program. 

SAVING TRACE OUTPUT 

In the OS/2 operating environment, the 
REXX processor generally uses the 
default input and output streams STDIN 
and STDOUT to read from the keyboard 
and write to the display. Trace output, 
on the other hand, is written to the 
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ft******************************************************************** 

** REVERSE.CUD 

** Filter to reverse lines in a file 
** - Uses standard piping/redirection 

********ti**^*******************************************#***********/ 

trace.value - trace("OFF') /* interactive trace */ 

if trace value = J ?R' then trash - trace('R') /* must be off */ 


do while lines('STDIN') 
line - linein('SIDIN') 
line - rever$e{line) 
call lineout 'STD01FT, line 
end 


Figure ft Resetting trace action in a filter 

STDERR output stream. Thus it is very 
easy to save or print trace output by 
executing the program with STDERR redi¬ 
rected to a file or a printer. The lan¬ 
guage processor detects when STDERR 
has been redirected and will not allow 
interactive trace to be switched on. 
When using redirection, STDERR is refer¬ 
enced by the internal file ID (handle) 2. 
When entered at the OS/2 command 
prompt this example will execute the 
program HTAPP and redirect any trace 
output to the file TRACE.OUT: 

MVAPP 2>TRACE.DUT 

The OS/2 PMREXX utility allows exe¬ 
cution and debugging of REXX pro¬ 
grams within a Presentation Manager 
window. It can also be used to save 
trace output. Among the many features 
of PMREXX are scrolling and saving out¬ 
put, selective copying to the clipboard, 
pasting to input, and switching interac¬ 
tive trace on and off with the mouse. 

PMREXX is an optional system utility 
in OS/2 2.0 and 2.1. If it was not origi¬ 
nally installed it can be installed from 
the OS/2 desktop by selecting OS/2 
System, System Setup, Selective Install, 
System Configuration (click on 'OK'), 
OS/2 Setup and Installation, Optional 
System Utilities in OS/2 Installation, 
and PMREXX. 


/* read line from STDIN */ 
/* reverse line */ 
f* write line to STDOUT */ 


USING RXTRACE ENVIRONMENT 
VARIABLE 

The REXX processor provides an exter¬ 
nal means of switching on interactive 
trace in the OS/2 operating environ¬ 
ment. If the environment variable 
RXTRACE is set to ON, the language proces¬ 
sor will automatically set the trace 
action to ?R. It is, therefore, not neces¬ 
sary to modify a REXX source file to 
switch on interactive trace. The RXTRACE 
environment variable is most helpful 
for remotely debugging user problems 
that cannot be duplicated. The user can 
easily provide the trace information 
needed by switching trace on with SET 
RXTRACE=DN, executing the program with 
the trace output (STDERR) redirected to a 
file or printer, and then sending the 
output to the programmer. 

Using the RXTRACE environment vari¬ 
able works quite well unless the 7R 
trace action is not the preferred or 
appropriate setting. For instance, ?I 
might be preferred because it provides 
more detailed trace information. Or, if 
the program is a filter, then interactive 
trace is not appropriate because the lan¬ 
guage processor will try and interpret 
the STDIN input stream as REXX instruc¬ 
tions. In these cases, some additional 
code can correctly reset the trace action. 

The REVERSE.CMD sample pro¬ 
gram demonstrates how to program¬ 


matically test and reset the trace action. 
REVERSE.CMD is a simple filter that 
takes lines from STDIN, reverses them 
with the REVERSED built-in function and 
then writes to STDOUT. Because It is a fil¬ 
ter, REVERSE.CMD will not execute 
correctly in interactive trace mode. If 
interactive trace has been switched on 
using the RXTRACE environment variable, 
the first two lines of the program will 
reset the trace action. The first line calls 
the TRACEO function to query the current 
trace action and immediately turn trac¬ 
ing off. The current trace action is 
stored in the TRACEJALUE variable. The 
second line checks TRACEJALUE; if it was 
set to ?R, the trace action is reset to R, as 
shown in Figure 11. 



AUTOMATING TEST CASES 

An important part of application devel¬ 
opment and maintenance is verifying 
that a program works as designed in 


With the commands 
available in REXX, it 
is simple to 
automate running 
test cases that will 
test the complete 
program or specific 
routines within the 
program. 



the original release and in successive 
generations of enhancements and 
maintenance. This validation is done 
with test cases. Two problems in run¬ 
ning test cases is the time it takes to 
execute them and the difficulty of 
designing tests that fully validate ali of 
the program's routines. With the com- 
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mantis available in REXX, it is simple to 
automate the running of test cases that 
M-un. test com pl ete program or spe- 
cific routines within the program. 

It was discussed earlier that testing 
can be done during interactive trace by 
entering REXX instructions from the 
keyboard. Those instructions are inter¬ 
preted immediately by the language 
processor* The INTERPRET instruction will 
also process REXX instructions. Cre¬ 
ative use of the INTERPRET instruction 
allows programmers to exercise control, 
similar to interactive trace, from outside 
the program. 

The DEBUGJUC.CMD program, 
shown in Figure 12, demonstrates how 
to take instructions from a file of test 
cases and execute them with the INTER¬ 
PRET instruction. The RUN_TEST_CASES rou¬ 
tine in DEBUG_RX.CMD provides this 
function. If the program Is started with 
a parameter of TEST, then the SIGNAL 
instruction transfers control to the 
RUN JESCCASES routine, which reads the 
DEBUG_RX.T3T file. As each line is 
read, it is processed by the INTERPRET 
instruction, 

DEBUG_RX.TST, shown in Figure 
13, contains instructions that test the 
MFFO routine in DEBUG_RX.CMD. This 
file looks similar to a REXX file because 
it contains REXX instructions; however, 
each line represents a literal string that 
will be processed by the INTERPRET 
instruction. INTERPRET requires that all 
instructions, such as 00,. .END and 
IF.. .THEN, be complete. Therefore, 
instructions and comments in the test 
case file cannot span multiple lines. 
Long instructions are pieced together in 
multiple assignment statements with a 
semicolon separating the clauses. The 
basic test scenario for DIFF() is assigned 
to the variable TEST in this manner. The 
test cases are run by changing the val¬ 
ues of the variables used in TEST and giv¬ 
ing the instruction INTERPRET TEST 
{RUN JEST.QSES actually executes INTERPRET 
INTERPRET TEST). All messages are written 
to STDERR so they can be easily redirected 
to a file. 

Incorporating this method of saving 
and running test cases into the develop- 




Figure 12, Program that reads and executes its own test cases 
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Figure 13. Sample test cases farDEBUG_RX.CMD 

merit process improves the quality of development, and the level of docu- 
the code produced, the efficiency of mentation. The quality of the code is 


improved because there is a record of 
the actual test cases that have been run. 
The efficiency of development 
improves because test cases are cap¬ 
tured as each function is developed 
rather than as an afterthought once 
coding is complete. The level of docu¬ 
mentation improves because the test 
cases illustrate exactly what a piece of 
code is expected to do. 



SUMMARY 

Debugging REXX programs has a num¬ 
ber of similarities with other languages 
and debug utilities* Adding a trace 
command into a REXX program is 
equivalent to setting a breakpoint into 
other languages. Other languages or 
utilities may also have the ability to 
examine variables, set variables, and 
even step through program execution 
interactively. In addition, REXX has a 
number of unique debugging features 
such as the ability to change the trace 
action, execute instructions, and call 
subroutines interactively. It can also 
reexecute a line of code or a subroutine. 
These features combine to create a very 
efficient debugging environment. 
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in accounting from Georgia State University, 
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Smalltalk/V is a pure object-oriented language unencumbered by the need to support procedural code. With it, 
you can create robust production code more quickly than if you were to program from a C source. 

BY THEODORE SHRADER 


Enhancing Your 
Smalltalk/V Programs 



y nlike C++, Smalltalk/V is a pure object- 
oriented language unencumbered by the 
need to support procedural code. With it, 
you can quickly prototype code, particularly that 
used to design and test graphical applications. The 
code can then be further refined to create robust 
production code, more quickly than if you were to 
develop from a C source. 


INTRODUCTION 

Making the transition from C (or another proce¬ 
dural language) to Smalltalk takes time. In a first 
attempt, developers are likely to shape the 
Smalltalk classes and methods to follow C pro¬ 
gramming concepts. For example, a new Smalltalk 



Unlike a compiled language, 
Smalltalk allows you to modify code 
while the program is running and 
view your changes immediately. 


developer may contain almost an entire program's 
methods under one class, rather than subdividing 
the work among all the classes and reusing as 
much code as possible. One of Smalltalk's great 
strengths is its ability to allow code to be subdi¬ 
vided and then frequently and easily reused. 

During the transition from procedural to object- 
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oriented programming, there are many ways to 
refine code, improve performance, and make 
development and maintenance easier. Unlike a 
compiled language, Smalltalk allows you to modi¬ 
fy code while the program is running and view 
your changes immediately thereafter. Finally, you 
can improve program performance by becoming 
aware of how Smalltalk objects and methods inter¬ 
act. This article focuses on intermediate improve¬ 
ments you can make toward the design and imple¬ 
mentation of your Smalltalk/V for OS/2 code. 

DESIGNING 

One of the best ways to maximize code reuse is to 
focus on designing the class structure for your pro¬ 
gram. It helps to first analyze the classes shipped 
with Smalltalk; examining existing classes and 
methods can give you an idea of where to place 
your own classes and which classes can be recy¬ 
cled by your application. Planning ahead doesn't 
mean that your initial class structure can't be 
changed, but it will save you from having to 
rearrange classes and methods in the future. 

Wherever you place your classes, determine if 
it would be better to create a new class as a sub¬ 
class of an existing one (thus taking advantage of 
inheritance) or if you should simply add to the 
methods of one of the base classes. A new class of 
an object, such as Corps, should be made a separate 
class, whereas new string methods are better off 
placed in the String class since it allows them to be 
shared by all String objects. Make a log of those 
methods added to existing classes; methods can be 
forgotten as the change log and source files are 
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Figure 1. USUnit object subclasses with instances of the strength variable 
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Figure 2. Responses to the isMounted message 


compressed. The log will allow you to 
move the code from one version of 
Smalltalk to another or from one image 
to another more easily. 

When adding a new class, it is a 
good idea to prefix the name of the 
class with a two- or three-letter prefix 
common to all the classes in your pro¬ 
gram (for example, USInfantry). This will 
keep classes sorted together or in clus¬ 
ters in the Class Hierarchy Browser, 
immediately identifying them to you or 
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to other developers as those belonging 
to your program. (Some development 
environments for Smalltalk separate 
out the classes used for your applica¬ 
tion, shielding you from unused parts 
of the class hierarchy. This makes navi¬ 
gation easier, but with a good naming 
scheme you can minimize scrolling 
between classes and retain the same 
functionality.) 

Methods and variables should fol- 
low a naming scheme that visually 


indicates parameters and object type. 
For methods, this means placing an 
abbreviated object name before each 
variable input. For example, the String 
method: 


replaceChar: affLdChar withChar: aNew- 
Char 


tells the unfamiliar or forgetful devel¬ 
oper that character (not string) objects 
are needed as input. 

Instance and class variables should 
also be named according to the type of 
object, as with aString, aChar, and 
strengthDict. The latter variable name 
tells the reader not only that the vari¬ 
able holds a dictionary, but also that it's 
a strength dictionary (Oooh). 

Let's say you are designing a pro¬ 
gram to represent units on a map. You 
know that there will be different kinds 
of units, such as Infantry, Cavalry, and 
Artillery, that have unique characteris¬ 
tics, but there will also be commonali¬ 
ties such as the attributes of name and 
strength. In this example, while a unit's 
name is a string object for each unit, the 
strength instance variable takes on a 
different value for each unit. Whereas 
for Infantry this variable stores the 
number of troops, for Cavalry it stores 
the number of mounted troops. An 
Artillery's strength, finally, is expressed 
in the number of its gun batteries. 

In fact, instead of an integer value 
for Artillery, strength could be 
expressed in terms of a dictionary 
keyed on the different types of guns, 
with an associated value of numbers of 
each. Querying messages sent to each 
unit could return a different composite 
strength value for each, with Infantry 
and Cavalry returning their strength 
instance values unmodified and 
Artillery needing to weigh each gun 
with a strength multiplier, multiplying 


of gun. (Infantry and Artillery are con¬ 
sidered polymorphic classes, since they 
respond to the same message with dif¬ 
ferent behaviors.) The sum of the three 

'■aiues would be refumed as a unit's 

composite strength, 
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Everything in Smalltalk is an object; 
object design can be extended further 
to make each gun an object, so the 
strength variable becomes a collection 
of USGun objects. With our base design, 
we add the following subclasses under¬ 
neath the Object class in the hierarchy; 

USUnit 

USArtillery 

USCavalry 

USInfantry 

Figure 1 shows the USUnit class struc¬ 
ture. The USUnit class, which holds the 
name and strength instance variables, is 
considered an abstract object because 
no one will ever create an instance of it 
Instead, it is meant to share the meth¬ 
ods and variables inherited by its sub¬ 
classes, which will have instances cre¬ 
ated of them. After placing dummy 
methods that return a default answer to 
common methods in this class, the sub¬ 
classes can choose to implement dass- 
specific corresponding methods. While 
USCavalry could then answer true to the 
isNounted method, USArtillery and USIn- 
fantry wouldn't have to implement this 
method because the default method 
isHounted would already exist in the 
USUnit class and would always return 
false. Figure 2 illustrates responses to 
the isftounted message (method). 

USING COLLECTIONS 

Collections, with their many incarna¬ 
tions, are one of the most used objects 
in Smalltalk, yet because of their flexi¬ 
bility and availability, developers tend 
to overuse them; their proliferation can 
easily create a drag on program perfor¬ 
mance. Much of this degradation can 
be traced back to the overhead need to 
support each collection, especially the 
more complex ones, as well as the 
search algorithms used to access or 
retrieve data from their vessels. A care¬ 
ful examination of the use of instances 
of these objects can dramatically 
increase the speed, efficiency, and 
capacity requirements of your pro¬ 
gram, If you know the maximum size a 
collection will be, create it with that 
size, as with the statement: 


dataLineQt := OrderedCollection new: 
175, 

This is better than using OrderedCol- 
lection new, which supplies a default of 
only twelve entries. When the objects to 
be added exceed the size of the collec¬ 
tion, the collection is forced to grow. 
Even though Smalltalk handles this sit¬ 
uation automatically, growing is an 
expensive, time-consuming task, espe¬ 
cially for large collections. Every time a 
collection grows, it must recalculate its 
new size, create a new object with that 
size, and copy the contents of the old 
collection into the new one. The default 
growth size for IndexedCollections, which 
includes OrderedCoHections, is: 

self size + (self size // 3 + 10} 

Initializing a collection to its maxi¬ 
mum size doesn't bloat the memory 
needed to store the collections as it 
waits to be populated, because new 
entries are initialized to nil values. 
Dictionaries are useful collections 
because they retrieve values immedi¬ 
ately. This feature comes with a price, 
however; Smalltalk must create and 
maintain their complex structure. Keys 
can be referenced to retrieve values 
quickly, as with: 

unitDict at: '5th Reg' 

rather than using other structures or 
stepping through a collection of associ¬ 
ations: 

unitAssocdt do: [ :anAssoc | 

(anAssoc key = '5th Reg') 
ifTrue: ['"(anAssoc value)]]. 

Don't shy away from using dictio¬ 
naries, but be sure to use a collection 
right for the job at hand. DrderedCoTLee- 
tions are cheaper to use than dictionar¬ 
ies; arrays are cheaper still. 

If a method creates a collection 
every time it is called, make the collec¬ 
tion an instance or class variable. This 
saves resources otherwise necessary to 
create and return the collection every 
time the method is called, especially if 


the frequency of calls is high. For exam¬ 
ple, USArtillery could have a class 
method that initializes and returns a 
dictionary of guns to be used by the 
strength instance variable: 

initStrengthDict 
"((Dictionary new) 

at: '10-pdr. Parrott' put: 0; 
at: '12-pdr, Whitworth' put: 0; 
at: '24-pdr. James' put: 0) 

Now when an instance of USArtillery 
sends a message to itself with self class 
initStrengthDict, it can use the returned 
dictionary as its base. Since dictionar- 

Garbage collecting 
gives Smalltalk a major 
advantage over C++... it 
frees developers from 
having to allocate and 
deallocate space when 
interacting with Smalltalk 
methods and objects. 



ies take time to construct, it's a better 
idea to add the following methods that 
will create the base strength dictionary 
once, store it in a class variable, and 
allow the variable to be retrieved by 
instances of the object or other objects 
as well: 

initdassVars 
strengthDict := self 
initStrengthDict* 
freedassVars 
strengthDict := nil. 
strengthDict 
"strengthDict 

However, if strengthDict changes, it 
will return the latest changes rather 
than a fresh dictionary until it is reini- 
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tiaiized. Senders of this method should 
assign their returned dictionary to 
another value if they want to make dis¬ 
tinct modifications. 

You can streamline searches of a col¬ 
lection with existing methods such as 
select and collect or with subsets that 
remain stable through a number of 
searches. Try to reduce the number of 
times a collection is searched for a 
value. It is easy to use collections, yet 
the search time naturally and dramati¬ 
cally grows the larger the collection. 


CREATING VARIABLES 

Whether local, instance, or class, vari¬ 
ables are easy to set in Smalltalk, since 
their object types need not be declared. 
As with previous examples, with this 
flexibility comes the need for restraint. 
Keeping the number of temporary vari¬ 
ables down will keep your stack size 
from ballooning unnecessarily, especial¬ 



For the most part, with 
Smalltalk you don't 
waste time tracking 
down memory errors. 


ly if the methods in which the variables 
reside are called recursively. Limiting 
the use of local variables and keeping 
methods small will speed up your pro¬ 
gram, since Smalltalk can compile meth¬ 
ods as the program runs and store more 
of them in a cache before having to 
swap them out for other methods. 

Block statements can be handy, 
especially when setting up error check¬ 
ing rules. The following example sets 
up a block statement that can be stored 
in a dictionary and used with a collec¬ 
tion of blocks to check values stored in 
the ErrorCheck object. ErrorCheck will vary 
according to implementation, but in 
this case it stores the values to be 
checked and uses an instance variable 


to store the result of the check: 

block := [ :anErrorCheck I 

anErrorCheck result: (anErrorCheck 
value > 300)] 

If temporary variables are used 
within a block, however, be sure to set 
them to nil after they are used. Other¬ 
wise, Smalltalk will not be able to 
garbage collect them from the block's 
stack and reclaim their space. This will 
also cause problems if the variable 
points to an object that you think was 
already deleted. 

GARBAGE COLLECTING 

Even those new to Smalltalk are proba¬ 
bly aware that Smalltalk busies itself at 
times, scurrying around to reclaim 
unused space. Objects that no longer 
have references are cleaned up and 
their space is made available to future 
objects. Objects can be unreferenced 
either when their local variables are no 
longer needed after a method has com¬ 
pleted or when the variables are set to 
nil. It's good practice to set all unneed¬ 
ed instance or class variables to nil. You 
may also want to create initlnstVars, 
f reelnstVars, initCLassVars, and f reeCLass- 
Vars methods and call them upon the 
initialization and freeing (if postpro¬ 
cessing needs to be done before the 
object is unreferenced) of an object. 

Garbage collecting gives Smalltalk a 
major advantage over C++ because it 
frees developers from having to allo¬ 
cate and deallocate space when inter¬ 
acting with Smalltalk methods and 
objects. However, when dealing with 
PM structures and API calls, you will 
need to copy your objects to non- 
Smalltalk memory to prevent the 
garbage collection of objects that span 
the Smalltalk realm. For the most part, 
with Smalltalk you don't waste time 
tracking down memory errors. 

CONCLUSION 

This article has presented a few tips and 
strategies to help tune your code and 
recommend possible areas for enhanc¬ 
ing your Smalltalk programming style 


pertaining to the design and develop¬ 
ment of Smalltalk/V for OS/2 32-bit 
applications. The moral of Smalltalk is, 
"Don't be afraid to rewrite." Most code 
is not perfect the first time, and 
Smalltalk allows changes to be made 
and tested quickly. Your code will 
become tighter with a hindsight exami¬ 
nation, and you'll be able to add to your 
own list of development and perfor¬ 
mance enhancements. 
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Discover why FoxPro, Clipper, 
and dBASE were all written in C. 


^here is a good reason why 
• your database language was 
developed in C. In fact, there 
are many good reasons. 


C code is small. C code is fast, C code is 
portable, C code is flexible. C is the 
language of choice for today's professional 
developer With the growing complexity of 
database applications, C is a realistic 
alternative. Now with CodeBase 5,0* you 
can have all the functionality, simplicity and 
power of traditional database languages 
together with the benefits of C/C++. 


C speed • fast code, true executables... 

FoxPro, Clipper, and dBASE were written 
in C primarily for speed. But those compilers 
don't really compile, they combine imbedded 
language interpreters into your .EXE. Now 
that's slow. For dazzling performance you 
need the true executables of C. With 
CodeBase you get the real thing* C code. 
Consider the follow ing statistics, from the 
publisher of Clipper: 



"Sieve of Erastothenes 

Benchmark for Prime Number Generation 
Shows C to he incredibly faster! 

C size - small executables, 
no added overhead... 

FoxPro, Clipper and dBASE would like you 
to believe you need their entire development 
system to build database applications. But 
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remember, those products are all written in 
C. So w'hy do you need to lug all their extra 
code around? You don’t. CodeBase is a 
complete DBMS, in C. No fat executables 
stuffed with unused code. No runtime 
modules. No royalties. Just quality C code. 
CodeBase is just what you need. 


data files w ith any logical dB ASE expression. 
Our new Bit Optimization Technology 
(similar to FoxPro's Rushmore technology) 
uses index files to return a query on a 1/2 
million record data file in just a second. 
Automatically take advantage of this query 
performance by using our new CodeReponer: 


C portability -ANSI C/C++ 
on every hardware platform... 

No other language exists on more platforms 
than C/C++, Why rewrite your entire 
application for DOS. Windows, Windows 
NT, OS/2 or UNIX? With CodeBase the 
complete C source code is included* so you 
can port to any platform w ? ith an ANSI C or 
C++ compiler. Now and in the future. 

dBASE Compatible data, index 
and memo files... 

You want the industry standard. You need 
compatibility. Sure, dBASE is the standard, 
but every dBASE compatible DBMS 
product uses its own unique index and memo 
file formats. Only CodeBase has them all; 
FoxPro (.cdx), Clipper (.ntx), dBASE IV 
(.mdx) and dBASE III (,ndx). Now it's your 
choice, we re compatible with you* 

Announcing 
CodeBase 5.0 

The power of a complete DBMS, the benefit ) of C 

NEW - Multi-user sharing with 
FoxPro, Clipper and dBASE... 

Now your multi-user C/C++ programs can 
share data, index and memo files at the 
same time as concurrently running FoxPro, 
Clipper and dBASE programs. No 
incompatibilities. No waiting, 

NEW - Queries & Relations 
1000 times faster... 

CodeBase 5.0 now lets you query related 
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To use CodeReporter, 



simply draw your report, then include it in any 
program you write . Cal1403/437-2410 now for 
your FREE working model of CodeReponer 

New ■ Design complex reports 
in just minutes... 

Our new Code Re porter takes the painstaking 
work out of reports. Now simply design and 
draw reports interactively under Windows 3.1, 
then print or display them from any DOS, 
Windows or UNIX application. 

SPECIAL - FREE CodeReporter 

Order CodeBase 5 before August 30. 1993 
and receive CodeReporter for free! This 
offer includes our no-risk, 90-day money 
back guarantee* so order today! 



CodMcxse 5.0 

tna GC++ Library tot DataBase Management 



Call Now 
403-437-2410 
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Visual Reality 

While the competition plays catch-up, Borland continues to 
lead with the most graphical C and C++ for Windows, DOS, and OS/2. 


A more comfortable place 
to program 

Borland* C++ gives you the most 
intuitive Integrated Development 
Environment (IDE) for DOS, 
Windows, and OS/2.® This ease of 
use, combined with the fastest C++ 
compilation speed, means you get 
your work done faster. And 
Borland C++ includes time-saving 
C and C++ code generation and 
Application Frameworks." 
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To set standards you must 
meet standards 

Borland C++ is the only popular 
compiler that meets the certified 
ANSI C* and AT&T C++ stan¬ 
dards. You can be confident that 
as the language evolves to make 
programming easier and more 
powerful, your Borland C++ code 
will be ready to take advantage of 
future versions across all platforms. 
What’s more, applications built 




BORLAND C++ 
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90-day, money-back guarantee! 

See your dealer or call now, 
1-800-336-6464, ext. 5822 

In Canada call, I-800-461-3327. 
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with Borland C++ will deliver faster 
because you’ll have the most 
advanced features—like templates 
that make your code smaller, safer, 
and more reusable. 

#1 for real-world 



With more than one million copies 
in active use, Borland’s C++ is 
proven, polished, and finely tuned 
to meet the needs of C and C++ 
programmers. And Borland has the 
C++ that’s just right for you, from 
the new Turbo C++ Visual Edition 
for beginning programmers to pow¬ 
erful Borland C++ for professionals. 

Borland 

Power made easy 
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